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ABSTRACT 

^  Naval  shipboard  electric  power  systems  are  transitioning  from  the  relatively  simple 
distribution  of  ship  service  electric  power  to  extremely  complex  integrated  electric  drive 
(IED)  systems.  The  optimal  design  of  warships  employing  IED  is  presently  hampered  by  the 
lack  of  existing  simulation  computer  tools  for  analyzing  the  highly  coupled  and  controlled 
electro-mechanical  systems  characteristic  of  IED.  As  a  first  step  in  the  development  of  a 
viable  computer  simulation  tool,  the  numerical  algorithm  testing  program  WAVESIM  was 
created.  ^ 

^  The  key  contributions  of  WAVESIM  are  the  systematic  treatment  of  waveforms  as  an 
abstract  data  type,  the  development  of  the  terminal  description  of  devices,  and  the  use  of 
structural  jacobians  in  system  reduction.? 

c  WAVESIM  represents  variables  by  waveforms  consisting  of  a  vector  of  coefficients 
and  a  waveform  type  code  indicating  how  the  coefficients  should  be  interpreted.  The 
principal  advantage  of  using  waveforms  over  conventional  discrete  point  methods  is  the 
avoidance  of  unstable  integration  techniques  since  for  most  waveform  types,  integration  and 
differentiation  are  linear  matrix  operations,  rf- — . 

Devices  are  described  in  WAVESIM  by  relationships  between  terminal  interface 
variables.  WAVESIM  recognizes  two  types  of  terminals:  normal  terminals  having  both 
potential  and  flow  variables,  and  information  terminals  having  only  a  potential  variable.  In 
this  manner,  WAVESIM  can  simulate  processes  involving  both  energy  transfer  and  control 
signals. 

WAVESIM  extends  the  structural  jacobian  matrix  concept  to  reflect  the  properties  of 
the  dependence  of  system  equations  on  system  variables.  The  system  structural  jacobian 
matrix  is  constructed  from  the  constitutive  device  structural  jacobian  matrices  and  is  used  to 
identfiy  a  sequence  of  smaller  blocks  when  can  be  solved  consecutively  for  all  the  system 
variables. 

To  demonstrate  and  verify  the  capabilities  of  WAVESIM,  several  simulations  were 
conducted.  In  all  simulations,  WAVESIM  provide  results  matching  data  generated  by  other 
simulation  methods. 
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Chapter  1  Introduction 

A  revolution  is  occurring  in  modem  warship  design.  The  conventional  mechanical 
transmission  train  for  transferring  power  from  the  prime  movers  to  the  ships  screws  will  be 
replaced  in  future  warship  designs  by  an  integrated  electric  drive  (IED)  system.  While 
electric  drive  is  not  a  new  concept,  the  IED  approach  differs  significantly  from  previous 
electric  drive  implementations  in  that  both  propulsion  power  and  ship  service  power  (60  HZ 
440  Volts  AC)  are  derived  from  the  same  prime  movers.  The  resulting  flexibility  in  the 
arrangability  of  the  ship,  in  the  design  of  the  electric  plant,  and  in  the  power  available  to 
combat  systems  provides  the  naval  architect  with  many  opportunities  for  significantly 
improving  the  combat  effectiveness  of  modem  warships. 

Designing  a  ship  taking  full  advantage  of  the  opportunities  afforded  by  IED  is  not  an 
easy  task  or  even  obvious.  The  ship  designer  has  no  precedent  for  an  IED  ship  let  alone  the 
design  of  an  IED  electric  plant.  Instead,  the  designer  must  rely  heavily  on  simulations  of 
proposed  systems  to  evaluate  the  soundness  of  the  design.  For  the  electrical  power  system,  a 
suitable  simulation  environment  must  be  capable  of  addressing  these  questions: 

Will  the  Electric  Power  System  Work? 

This  is  the  ultimate  question  which  needs  to  be  answered.  Unfortunately  defining 
the  term  work  is  not  an  easy  task,  nor  is  assuring  a  system  will  work  under  all  operating 
conditions.  A  strict  time  domain  simulation  only  provides  a  solution  for  a  given  set  of 
operating  conditions.  Generalizing  the  results  of  relatively  few  simulations  to  all 
operating  conditions  is  both  necessary  and  prone  to  catastrophic  failure.  Hence  more 
than  just  a  time  response  is  usually  needed. 

How  Will  the  System  React  to  Major  Disturbances  and  Faults? 

The  primary  design  goal  for  shipboard  electric  power  systems  is  continuity  of 
power.  To  this  end,  the  response  of  the  system  to  abnormal  events  such  as  grounds, 
stalled  motors,  and  inadvertent  opening  of  breakers  is  crucial  to  evaluating  the  success 
of  the  electric  power  system  design. 

How  Will  the  System  React  to  Severe  Dynamic  Conditions? 

A  number  of  normal  events  can  cause  severe  dynamic  responses  within  the 
system.  Rapidly  changing  the  propulsion  motor  speed  or  direction,  discharging  pulse 
weapons,  or  starting  large  motors  are  all  examples  of  normal  dynamic  events. 
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Is  the  System  Stable  During  a  Given  Dynamic  Scenario? 

One  import  aspect  of  a  system  that  works  is  its  stability.  The  system  should 
remain  stable  during  all  normal  dynamic  conditions  and  for  as  many  disturbances  and 
faults  as  possible. 

What  is  the  Stability  Margin? 

Some  measure  of  how  stable  the  system  is  should  be  provided  to  assist  in 
generalizing  the  findings  of  stability  about  one  scenario  to  other  related  scenarios. 

What  is  the  Sensitivity  of  the  Results  to  Parameters? 

The  generation  of  models  for  a  dynamic  system  simulation  requires  some 
estimation  of  device  parameters.  Knowledge  of  the  sensitivity  of  the  simulation  results 
to  parameter  estimation  errors  is  crucial  for  correlating  simulation  results  with  what  can 
be  expected  from  the  physical  system. 

How  Correct  are  the  Answers  Provided  to  the  Above  Questions? 

Simulations  generally  use  numerical  methods  to  generate  solutions.  Careful 
control  of  error  propagation  is  very  important  in  ensuring  accurate  conclusions  can  be 
drawn  from  the  simulation  results.  Some  form  of  feedback  should  be  provided  to  the 
operator  as  to  the  confidence  level  of  the  results. 

These  requirements  for  performing  time  domain  simulations  of  proposed  and  existing 
electric  power  systems  found  on  United  States  naval  warships  can  be  quite  challenging.  The 
size,  complexity,  and  strong  coupling  of  components  all  conspire  to  make  the  simulator’s 
task  difficult.  At  first  glance,  one  would  think  the  simulation  programs  designed  for  the 
commercial  power  utilities  would  be  sufficient  for  handling  the  smaller  shipboard  systems. 
Unfortunately,  this  is  not  the  case  due  to  the  following  differences  of  the  shipboard  system 
from  commercial  power  systems: 

Variable  Frequency 

Frequency  cannot  be  assumed  constant.  Many  IED  designs  have  the  generators, 
motors,  and  ship  service  power  all  operating  at  different  frequencies  to  optimize  the 
performance  of  individual  components.  Frequency  changers  are  employed  to  convert 
the  power  from  one  frequency  to  another.  Even  the  ship  service  system  onboard 
mechanical  drive  ships  can  experience  frequency  fluctuations  lasting  up  to  2  seconds. 
The  limited  rotational  intertia  of  the  prime  movers  and  generators  allows  for  rapid 
accelerations  and  decelerations  of  the  shaft  and  corresponding  frequency  fluctuations. 
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Lack  of  Time  Scale  Separation 

The  principal  time  constants  of  controls,  machine  dynamics,  and  electric 
dynamics  all  fall  within  the  same  general  range  of  milliseconds  to  seconds.  The 
practice  of  decomposing  the  problem  by  time  scale  separation  often  used  in  analyzing 
commercial  power  systems  becomes  much  more  difficult. 

Load  Sharing  instead  of  Power  Scheduling 

The  commercial  power  utilities  operate  by  scheduling  the  power  delivered  by 
each  of  the  generating  units.  The  mismatch  between  scheduled  power  generation  and 
the  actual  load  is  met  by  a  swing  generator.  Onboard  ship  however,  both  real  and 
reactive  power  are  shared  equally  among  all  paralleled  generators  through  the  very  fast 
exchange  of  load  sharing  information.  This  fast  exchange  of  information  strongly 
couples  the  dynamics  of  all  the  paralleled  generators. 

Short  Electrical  Distances 

The  distances  onboard  ship  are  so  short  (under  1000  ft)  as  to  make  the  modelling 
of  transmission  lines  unnecessary  for  most  simulations  and  to  trivialize  the  load  flow 
problem  which  is  so  important  to  the  commercial  power  sector.  The  short  electrical 
distances  also  strengthen  the  coupling  of  the  various  subsystems  making  up  the 
electrical  power  system. 

Load  Dynamics 

Commercial  utilities  usually  assume  loads  are  either  consuming  constant  real  and 
reactive  power,  or  are  constant  impedances.  Shipboard  systems  however,  must  account 
for  dynamics  of  loads  such  as  propulsion  motors,  large  pumps,  pulsed  loads,  propeller 
dynamics,  and  ship  dynamics.  Furthermore,  the  supervisory  level  control  envisioned 
for  future  designs  may  have  the  ability  to  control  aspects  of  the  loads  in  addition  to 
generation. 

Tighter  Control 

Because  a  ship  is  relatively  small,  a  higher  level  of  control  can  be  exercised  over 
the  shipboard  power  system  than  can  be  exercised  in  the  commercial  power  industry. 
This  higher  level  of  control  strengthens  the  dynamic  coupling  of  components  of  the 
system  and  complicates  simulation  efforts. 

Clearly,  shipboard  systems  are  considerably  different  from  commercial  power  systems; 
and  the  inapplicability  to  shipboard  power  systems  of  simulation  techniques  developed  for 
commercial  systems  should  not  be  surprising.  Other  simulation  tools  exist  but  for  one  or 
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more  reasons,  all  are  ill-suited  for  simulating  shipboard  systems.  A  review  of  currently 
available  commercial  software  for  solving  lumped  parameter  systems  reveals  no  program 
currenty  exists  suitable  for  fulfilling  the  needs  of  simulating  shipboard  electric  power 
systems. 

Circuit  Simulators 

As  will  be  discussed  in  following  sections,  circuit  simulators  almost  universally 
describe  devices  in  terms  of  branch  voltages  and  currents.  The  constitutive 
relationships  are  based  only  on  the  relative  difference  of  the  terminal  variables  and  can 
not  depend  on  the  actual  nodal  potentials.  Furthermore,  the  flow  variables  must  be 
conserved  on  the  device  level.  While  these  restrictions  are  not  of  concern  for  electrical 
networks,  they  are  a  bit  constraining  on  electro-mechanical  systems  where  one  would 
like  to  deal  with  energy  trai ^formations  in  a  device  by  employing  equations  which  do 
not  conserve  the  flow  variable  on  the  device  level.  The  torque  on  the  input  shaft  of  a 
gearbox  for  example,  does  not  equal  the  torque  on  the  output  shaft.  Even  electric 
power  models  where  the  flow  variable  is  power  and  the  potential  variable  is  voltage  can 
best  be  described  by  constitutive  equation  which  do  not  enforce  conserving  power  by 
ignoring  the  power  converted  to  heat  through  resistive  losses. 

Many  circuit  simulator  also  have  problems  modelling  the  transfer  of  information 
which  is  common  in  systems  employing  control  systems.  Information  has  only 
potentials  and  no  flows  associated  with  it. 

Signal  Analysis  Software 

Signal  Analysis  Software  is  often  used  to  simulate  control  systems  but  often  have 
difficulty  simulating  energy  transfer.  In  particular,  these  programs  often  are  incapable 
of  solving  implicit  equations  which  are  typically  created  by  writing  Kirchhoff’s  Current 
Law  when  developing  systems.  Instead  much  effort  must  be  expended  to  ensure  the 
models  have  the  appropriate  input  and  output  variables  for  a  given  system  to  be  built. 

Commercial  Power  Utility  Analysis  Programs 

Software  for  analyzing  commercial  power  universally  do  not  apply  to  shipboard 
systems  due  to  several  key  differences.  The  lack  of  transmission  lines,  rotational 
inertia,  time  scale  separation  of  dynamics  and  the  presence  of  tightly  coupled  control 
loops  are  all  features  of  the  shipboard  system  which  prevent  the  use  of  the  commercial 
power  system  analysis  techniques  [5]  [9]  [10]  [1 1]. 
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General  Differential  Equation  solvers 

Most  general  differential  equation  solving  programs  cannot  handle  implicit 
equations  very  well.  While  the  development  and  interconnecting  of  models  into 
systems  is  possible,  the  process  can  be  quite  cumbersome  [12]  [13].  Dynamically  stiff 
systems  also  pose  serious  challenges  to  the  general  differential  equation  solvers. 

Hybrid  Computers 

Hybrid  computers  for  studying  electrical  power  systems  can  answer  many  of  the 
desired  questions  for  small  shipboard  systems.  Unfortunately,  hybrid  computers  are 
very  expensive  and  limited  in  the  size  of  problems  which  can  be  addressed.  Presently 
the  only  hybrid  computer  in  the  United  States  suitable  for  shipboard  power  system 
studies  is  located  at  Purdue  University.  While  this  machine  is  capable,  the  needs  of  the 
IED  program  will  require  digital  computer  techniques  for  performing  the  desired 
studies.  [92]  [93]  [94]  [95]  [96] 

As  part  of  an  effort  to  fill  the  need  for  simulating  shipboard  power  systems,  the 
WAVESIM  program  was  specially  created  to  develop  applicable  simulation  techniques. 
Before  discussing  the  numerical  methods  employed  in  WAVES1"'  1,  a  review  of  existing 
methods  is  appropriate. 

1.1  Simulation  Process 

The  process  of  simulating  a  physical  system  can  be  broken  into  three  steps.  First,  a 
system  of  equations  describing  the  component  device  constitutive  relationships  as  well  as 
the  network  constraints  must  be  developed.  While  the  network  constraints  are  purely  linear 
algebraic  equations,  the  constitutive  equations  can  be  nonlinear  and  dynamic.  Together,  a 
system  of  nonlinear  differential  algebraic  equations  is  generated.  The  next  step  is  the 
conversion  of  the  system  of  differential  algebraic  equations  into  a  sequence  of  purely 
algebraic  equations.  Common  integration  techniques  include  the  forward  and  backward 
Euler  methods.  Trapezoidal  rule  integration,  and  the  Runge-Kutta  methods.  Finally,  the 
nonlinear  algebraic  system  is  solved  either  through  the  Newton-Raphson  method  or  through 
one  of  several  relaxation  techniques. 

Before  describing  several  methods  for  generating  and  solving  the  system  of  equations 
corresponding  to  a  physical  system,  the  difference  between  the  branch  description  and 
terminal  description  of  devices  should  be  detailed.  The  branch  description  of  devices 
requires  all  the  constitutive  relationships  be  based  on  the  relative  difference  between 
terminal  potentials  and  all  flows  entering  a  device  also  leave  the  device.  Hence  for  a  two 
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terminal  device,  there  is  a  single  branch  potential  variable  and  a  single  branch  flow  variable 
associated  with  it.  In  the  terminal  description,  the  potential  and  flow  associated  with  each 
terminal  are  variables.  A  two  terminal  device  would  then  have  four  variables  associated 
with  it:  two  flow  variables  and  two  potentials.  The  terminal  description  allows  the 
constitutive  equations  be  a  function  of  the  actual  values  of  the  terminal  potentials  and  not 
only  of  the  potential  difference.  In  other  words,  the  potential  reference  can  be  set  at  the 
system  level  and  not  necessarily  on  the  device  level.  Furthermore,  the  flows  are  not 
required  to  be  conserved.  A  gear  box  for  example,  has  differing  torques  entering  and 
exiting  it.  The  branch  description  method  requires  a  four  terminal  model  of  the  gear  box 
while  the  terminal  description  requires  only  two  terminals.  In  either  case  the  result  would 
be  four  variables  describing  the  gearbox,  but  the  branch  description  requires  an  explicit 
declaration  of  the  device  potential  reference  while  the  terminal  description  uses  an  implicit 
system  wide  potential  reference. 

Branch  Description  vs.  Terminal  Description 


+ 

V 
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1.2  Developing  System  Equations 


The  normal  method  of  describing  a  dynamic  system  is  to  generate  a  consistent  set  of 
possibly  nonlinear  differential  algebraic  equations  and  arrange  them  into  the  following 
canonical  form: 

Cx  =f(x,y,u) 

0  =  g(x,y,u) 

where  x  is  the  vector  of  dynamic  state  variables,  y  is  the  vector  of  state  variables  with  no 
associated  dynamics  staes,  and  u  is  the  vector  of  system  inputs.  This  system  of  differential 
algebraic  equations  (DAE)  can  be  generated  several  different  ways  with  the  most  common 
being  the  Sparse  Tableu,  Modified  Nodal  Analysis,  and  the  standard  load  flow  method. 

The  method  employed  in  WAVESIM  does  not  extract  the  differential  equations  from 
the  device  constitutive  equations  but  instead  forms  a  system  of  algebraic  equations  of  the 
form: 

0  =  g(x,gi(x„ui),u) 

where  x  is  the  vector  of  the  system  variables  and  g,()  is  a  device  function  having  subsets  x, 
and 

of  x  and  u  as  arguments.  The  functions  g/0  have  the  dynamics  of  the  device  contained 
within  them,  but  these  dynamics  are  not  expressed  on  the  system  level. 
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1.2.1  Sparse  Tableau  Method 


The  Sparse  Tableau  method  is  a  very  general  method  for  describing  systems 
employing  the  branch  description  of  devices.  Proposed  in  [4]  and  used  in  the  ASTAP  and 
SPICE  simulators  [1][15][16],  the  Sparse  Tableau  method  breaks  the  system  equations  and 
variables  each  into  three  groups.  The  three  sets  of  variables  are  the  branch  currents,  branch 
voltages,  and  the  nodal  voltages.  The  three  sets  of  equations  are  the  node  Kirchhoff 
Current  Law  (KCL)  equations  in  terms  of  the  branch  currents,  Branch  Voltage  equations 
relating  branch  voltages  to  nodal  voltages,  and  the  Constitutive  equations  relating  branch 
voltages  to  branch  currents. 

Figure  1.2.1-1  RC  Example:  Sparse  Tableau 


0 


Figure  1. 2.1-1  shows  an  example  of  a  simple  RC  charging  circuit.  Using  the  Sparse 
Tableau  approach,  the  system  variables  are: 

4  Voltage  Source  branch  current 

iK  Resistor  branch  current 

ic  Capacitor  branch  current 

vs  Voltage  Source  branch  voltage 

vR  Resistor  branch  voltage 

vc  Capacitor  branch  voltage 

e,  Node  1  potential  (voltage) 

e2  Node  2  potential  (voltage) 

Note  the  reference  node  0  is  assigned  a  potential  of  0. 
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The  KCL  equations  are  given  by: 

4  4  =  o  — 4 + 4  =  ® 

The  Branch  Voltage  equations  are: 

vs  —  e,  =  0  vc  -  e,  =  0 

The  Constitutive  equations  are: 

vs-Vs  =  0 

v*-4*  =° 

While  the  Sparse  Tableau  approach  generates  a  consistent  set  of  network  equations, 
the  size  of  the  system  is  relatively  large  (eight  equations  in  eight  unknowns  for  this 
example).  Furthermore,  the  method  employs  the  branch  description  of  devices  which 
complicates  the  development  of  electro-mechanical  models. 


dvc 

C-£  =  0 

dt 
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1.2.2  Modified  Nodal  Analysis 


The  Modified  Nodal  Analysis  method  generates  a  compact  set  of  system  equations 
for  systems  of  device  models  using  branch  descriptions.  Modified  Nodal  Analysis  (MNA) 
was  formalized  in  [6],  described  in  [1][16],  and  employed  in  the  circuit  simulator  MSINC. 
The  procedure  consists  of  writing  the  KCL  equations  for  all  but  the  reference  node  in  terms 
of  the  branch  currents,  replacing  the  branch  currents  wherever  possible  with  constitutive 
equations  in  terms  of  the  branch  voltages,  appending  any  remaining  constitutive  equations, 
and  substituting  the  branch  voltages  with  the  corresponding  nodal  voltages. 

Figure  1.2.2-1  RC  Example:  Modified  Nodal  Analysis 


0 

Figure  1. 2.2-1  shows  a  simple  example  of  a  simple  RC  charging  circuit,  the  MDA 
approach  would  first  write  the  KCL  equations: 

h  ■*"  4  =  0  +  *c  =  0 

Substituting  the  constitutive  relations  results  in: 

1  1  dvc 

‘sV*-0  -Rv’+Cir=0 

The  extra  constitutive  equation  is  given  by: 

v,  -  Fs  =  0 
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Substituting  the  nodal  voltage  results  in  the  system  of  three  equations 


is+R('g  >-*?2)  =  0 


1  de2 

-^(e,-el)+C~  =  0 


e,-Vs  =  0 


While  the  Modified  Nodal  Analysis  Method  generates  a  compact  set  of  equations,  it 
does  require  the  use  of  the  branch  description  as  well  as  the  explicit  definition  of  flow 
variables.  Both  restrictions  can  complicate  teh  modelling  of  electro-mechancial  devices. 
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1.2.3  Standard  Load  Flow 

The  Load  Flow  approach  is  traditionally  used  in  the  analysis  of  commercial  power 
systems.  For  this  application,  the  flow  variables  are  usually  real  and  reactive  power  while 
the  potential  variables  are  the  voltage  magnitude  and  phase  angle.  The  Load  Flow 
approach  is  a  variation  of  nodal  analysis  described  in  many  papers  and  texts  on  power 
systems  including  [14]  [29]  [31]  [35]  [49]  [50]  [76]  [101].  The  terminal  description  of 
devices  is  used  since  power  flow  is  not  conserved  on  the  device  level  (The  power  entering 
a  transmission  line  is  not  the  same  as  the  power  leaving  the  same  line).  The  basic 
procedure  is  to  write  the  KCL  equations  in  terms  of  the  node  potentials.  Nodes  with  ideal 
potential  sources  are  treated  specially  since  their  corresponding  flow  variable  is  not  a 
function  of  the  device  voltages. 


Figure  1.23-1  RC  Example  :  Load  Flow 


Figure  1. 2.3-1  shows  a  simple  RC  charging  circuit  using  the  terminal  description  of 
the  devices.  A  load  flow  approach  using  currents  as  the  flow  variable  would  result  in  the 
following  procedure: 

Write  the  KCL  Equation  at  nodes  without  potential  sources 

(r 2  *C1  =  0 


Substitute  Constitutive  relationships  for  the  flow  variables 


1,  ^.^d(va-vC2) 

^(v«“Vj,,)+C - — - =  0 
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Substiute  the  nodal  potentials 

1  de2 

jte-KJ+C-- 0 

All  the  remaining  variables  can  be  calculated  from  the  solution  of  this  differential 
equations.  The  load  flow  method  definitely  creates  a  very  compact  set  of  equations  (only 
one  in  this  case)  but  requires  the  flow  variables  be  defined  explicitly  in  terms  of  the 
potential  variables,  and  must  treat  ideal  potential  sources  as  special  exceptions.  Neither  of 
these  restrictions  is  attractive  for  a  general  electro-mechanical  system  simulator. 
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1.2.4  WAVESIM  Terminal  Description 


The  method  employed  in  this  thesis  is  similar  to  Modified  Nodal  Analysis  with  the 
exception  that  terminal  potentials  are  used  instead  of  branch  voltages  and  that  the 
constitutive  equations  are  only  expressed  on  the  device  level  and  never  expressed  on  the 
system  level.  Potential  difference  equations  are  appendended  to  the  system  of  KCL 
equations  to  equate  explicitly  defined  potentials  with  their  node  potentials.  For  the  RC 
example,  the  system  variables  are  given  by: 

isi  Voltage  Source  terminal  1  current 

ici  Capacitor  terminal  1  current 

e0  Node  0  potential  (voltage 

ej  Node  1  potential  (voltage) 

e2  Node  2  potential  (voltage) 

Figure  1.2.4-1:  RC  Example:  Terminal  Description 


The  KCL  Equations  for  the  RC  example  are  given  by: 

hi  "b  8it_iRi(eve2)  =  0 
hi  =  0 

h  +  8sjs2^si’eo)  +  8cjc2(hneo)  ~  0 
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The  Potential  Difference  Equations  are  given  by: 

—  8c_<ci  O'c;  >  eo) =  ® 
ei  ~  8sj*si(.hi*e o)  =  0 


eo  8g_vg(^g)  ~  0 


Note  that  a  reference  device  allowing  for  a  more  general  method  of  setting  the 
system  reference  points  is  employed  rather  than  a  reference  node.  While  the  number  of 
equations  is  twice  that  of  the  Modified  Nodal  Analysis  method,  flows  need  not  be 
conserved  on  the  device  level.  Furthermore,  the  system  of  equations  is  easily  partitioned 
into  a  sequence  of  five  blocks  for  a  more  rapid  solution  (two  lxl  blocks,  followed  by  a 
2x2  block,  followed  by  two  more  lxl  blocks). 
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1.3  Solving  System  Equations 

As  stated  earlier,  the  standard  approach  to  simulating  a  physical  system  is  to  generate 
a  system  of  differential  algebraic  equation  of  the  form: 

Cx  =f(x,y,u) 

0  =  g(x,  y,u) 

To  solve  this  system,  it  must  first  be  converted  to  a  system  of  purely  algebraic 
equations  by  substituting  the  differential  equations  with  discrete  approximations.  The  time 
history  of  a  variable  is  expressed  as  a  series  of  discrete  points  in  time  where  dynamics  are 
expressed  as  algebraic  relationships  between  the  values  of  a  variable  at  different  discrete 
times.  Standard  methods  for  performing  this  approximation  include  the  forward  and 
backward  Euler,  Trapezoidal  rule  integration  and  Runge-Kutta  methods. 

The  major  problem  with  this  approach  is  the  dependence  of  the  time  step  on  the  fastest 
mode  (smallest  eigenvalue)  of  the  dynamic  system.  This  forces  the  entire  system  be  solved 
with  a  very  fine  discretization  of  time,  even  though  large  portions  of  the  system  are  not 
affected  by  the  fast  mode. 

In  any  case,  the  system  of  nonlinear  algebraic  equations  must  be  solved.  The  two 
classes  of  solvers  most  commonly  used  are  variations  of  the  Newton-Raphson  Method  and 
several  relaxation  methods. 

1.3.1  Newton-Raphson  Method 

The  Newton-Raphson  method  works  well  for  most  systems  as  long  as  the  initial 
guess  for  all  of  the  variables  are  within  the  convergence  region  of  the  final  solution.  This 
method  is  used  in  SPICE  and  ASTAP  and  is  based  on  a  Taylor  series  expansion  of  the 
system  of  equations: 

FW  =  0  =  FW+7(r-)At  +  ... 

**  +  i=**  +  A* 

\=-r\xtjF(jt) 

The  matrix  J  is  called  the  Jacobian  Matrix  and  its  inverse  must  exist  for  the 
method  to  work. 
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1.3.2  Relaxation 


Relaxation  methods  assign  one  of  the  system  variables  to  each  of  the  system 
equations.  After  initial  guesses  are  made  for  each  of  the  variables,  the  variables  are 
updated  by  solving  their  corresponding  equation  assuming  none  of  the  other  variables  have 
changed.  The  two  most  popular  relaxation  methods  are  the  Gauss-Jacobi  (popular  with 
parallel  processing  computers)  and  the  Gauss-Seidel  method  (usually  used  with  serial 
processing  computers).  The  Gauss-Jacobia  calculates  updates  for  all  the  system  variables 
before  actually  performing  the  update: 


F(x)  =  0 


+  1»  •  •  -’Xn -l.k’Xn  -  l.tl  )  —  ® 


The  Gauss-Seidel  method  updates  the  system  variables  as  the  updates  are  calculated: 


F(x)  =  0 


+  i’X2.k*V  *  •  ',Xi,k  +  1*  ’ '  •>•*71  -  !,*>•*» -1,*3  )  ® 


1.3.3  Waveform  Relaxation 


An  alternate  method  to  solving  the  dynamic  equations  system  wide  is  to  solve  them 
equation  by  equation  over  a  given  time  interval.  The  Waveform  Relaxation  method 
represents  variables  by  a  sequence  of  points  representing  the  time  history  of  the  waveform 
over  a  given  time  interval.  Each  variable  can  be  discretized  differently  and  is  assigned  one 
of  the  system  equations.  The  system  equations  are  solved  over  the  waveform  interval  for 
their  assigned  variable  with  the  other  variables  held  at  their  current  waveform  values. 

Waveform  Relaxation  works  well  with  loosely  or  directionally  coupled  systems,  but 
does  not  work  well  for  tightly  coupled  systems.  The  method  does  however,  have  good 
multirate  performance  since  each  differential  equation  can  be  solved  using  a  time 
increment  appropriate  to  it. 

1.3.4  WAVESIM  Approach 

To  summarize  the  traditional  solving  methods,  the  standard  methods  employing 
Netwon-Raphson  can  handle  tightly  coupled  systems  but  perform  poorly  with  multirate 
systems  while  waveform  relaxation  performs  poorly  with  tightly  coupled  systems  but 
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efficiently  solves  multirate  problems.  Unfortunately,  the  shipboard  systems  have  both 
multirate  and  tightly  coupled  properties.  For  this  reason,  WAVESIM  combines  the 
Newton-Raphson  method  with  a  waveform  representation  of  variables. 

In  WAVESIM  variables  are  represented  over  a  time  interval  by  a  vector  of 
coefficients  along  with  a  type  indicator  for  specifying  how  the  coefficients  should  be 
inteipieted.  Common  interpretations  include  Legendre  Series  coefficients,  Chebyshev 
Series  coefficients,  and  polynomial  series  coefficients.  For  these  representations, 
integration  and  differentiation  are  linear  matrix  operations  and  the  issue  of  numerical 
stability  of  an  integration  technique  disappears.  Waveforms  can  usually  be  converted 
from  one  type  to  another  with  a  linear  matrix  operation  as  well. 

With  variables  represented  as  vectors  of  coefficients,  the  Newton-Raphson  method 
can  be  employed  for  solving  tightly  coupled  systems.  Good  multirate  performance  is 
achieved  through  the  linear  matrix  operator  for  integration  along  with  waveform 
smoothing  ,o  average  out  phenomena  faster  than  the  time  scale  of  interest. 

1.4  Thesis  Outline 

This  thesis  focuses  on  developing  a  digital  computer  simulation  environment  suitable 
for  studying  shipboard  electric  power  systems.  WAVESIM,  a  simulation  program  written 
in  the  C  programming  language  demonstrates  algorithms  for  simulating  systems  of 
nonlinear  lumped  parameter  models  representing  the  electro-mechanical  components 
composing  an  IED  system.  The  key  features  of  WAVESIM  are: 

Devices  defined  independent  of  the  encompassing  systems 

Devices  can  be  developed  and  tested  without  an  exact  knowledge  of  the 
topology  of  the  systems  incorporating  the  devices. 

Devices  described  using  the  Terminal  Representation  of  devices 

Device  constitutive  relationships  are  written  in  terms  of  the  actual  values  of  the 
terminal  potentials  and  not  in  terms  of  relative  potentials.  In  this  manner,  device 
equations  can  be  written  in  terms  of  a  system  reference  when  such  a  reference  level  is 
unambiguous.  Furthermore,  the  flow  variables  are  not  required  to  be  conserved  on  a 
device  level.  This  greatly  eases  the  task  of  modelling  flows  which  also  depend  on  a 
reference  potential  (power  for  example). 
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Devices  defined  independent  of  the  manner  in  which  terminal  interface  variables 
are  expressed. 

Devices  can  be  developed  w'thout  specifying  how  the  interface  variables  are 
specified.  In  WAVESIM,  variables  can  be  represented  many  different  ways,  all  of 
which  are  irrelevant  to  the  specification  of  the  constitutive  equations  making  up  the 
device. 

System  equations  instead  of  the  devices  resolve  input-output  conflicts. 

WAVESIM  does  not  constrain  normal  terminals  where  energy  is  transferred 
from  having  more  than  one  output  hooked  together  at  a  node. 

Interface  Variables  represented  by  waveforms 

Waveforms  are  a  vector  of  coefficients  which  specify  a  given  variable  over  a 
given  time  interval  instead  of  a  single  value  describing  the  variable  at  a  given  point  in 
time.  The  waveform  type  determines  how  the  coefficients  should  be  interpreted  for 
generating  values  of  the  variable  within  the  time  interval.  Representing  variables  as 
waveforms  has  the  primary  benefit  of  removing  the  issue  of  numerical  stability  of 
integration  techniques  from  the  simulation.  Integration  and  differentiation  are  merely 
operators  on  waveforms,  no  different  from  addition,  subtraction,  or  any  of  the 
trigonometric  operators. 

Differentiation  and  Integration  performed  on  the  device  level  instead  of  the 
system  level. 

Most  circuit  simulators  as  described  in  the  previous  sections  solve  the 
differential  equations  associated  with  device  constitutive  equations  on  a  system  level. 
This  method  eases  the  task  of  evaluating  the  stability  of  linear  systems  but  introduces 
new  problems.  If  the  eigenvalues  of  a  dynamic  system  are  widely  separated  in  value, 
the  simulation  time  step  must  be  made  very  small  for  the  entire  system  if  conventional 
integration  techniques  are  employed.  WAVESIM  solves  the  differential  equations  on 
the  device  level  and  employs  waveform  smoothing  to  remove  dynamics  which  occur 
faster  than  the  time  scale  of  interest. 

While  many  of  the  pieces  of  WAVESIM  are  not  new,  several  key  concepts  are 
presented  in  this  thesis  for  the  first  time: 

The  Terminal  Description  of  devices 

Instead  of  specifying  the  interface  of  devices  by  ports  consisting  of  a  potential 
difference  (branch  voltage)  and  the  flow  through  the  potential  difference  (branch 
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current),  the  terminal  description  of  a  device  assigns  a  potential  and  a  flow  entering 
the  device  for  each  normal  terminal.  Simulators  based  on  branch  voltages  and 
currents  require  all  of  the  flow  entering  a  device  to  also  leave  the  device.  In  this 
sense,  the  flow  is  conserved.  The  terminal  description  however,  does  not  require 
conservation  of  flow  within  a  device  (Conservation  of  flow  as  expressed  by 
Kirchhoff’s  Current  Law  -  KCL  is  required  at  connection  points  called  nodes).  The 
ability  to  construct  models  which  do  not  conserve  flows  can  simplify  models  where 
energy  transformations  occur,  the  reference  potential  is  clearly  known  for  the  system 
and  not  just  for  the  device,  and  certain  forms  of  energy  are  not  of  interest.  In  many 
mechanical  simulations  for  example,  the  amount  of  energy  lost  in  friction  is  not  of 
interest  to  the  modeler.  A  simulation  model  based  on  branch  potentials  and  flows  of  a 
device  experiencing  friction  would  be  required  to  reject  the  frictional  heat  through  one 
of  its  branches. 

The  terminal  description  also  allows  for  the  transfer  of  information  between 
devices  through  information  nodes  and  information  terminals.  This  feature  is 
essential  for  successfully  modelling  many  control  algorithms.  The  ability  to  mix 
control  signals  and  energy  transfer  through  flow  variables  within  the  same  simulation 
environment  is  a  major  advantage  of  the  terminal  description. 

The  Structural  Jacobian  method  for  building  and  reducing  systems 

The  concept  of  the  connection  matrix  for  specifying  the  participation  of  system 
variables  in  system  equations  is  expanded  to  include  the  structural  form  (i.e.  diagonal, 
linear,  nonlinear,  etc.)  of  the  dependence  of  the  system  equations  on  the  system 
variables.  The  codes  for  the  structural  Jacobian  adhere  to  a  simple  set  of  algebraic 
rules  which  can  be  used  to  construct  a  system  structural  Jacobian  matrix  from  the 
individual  device  structural  Jacobians.  The  system  structural  Jacobian  facilitates  the 
reduction  of  the  numerical  effort  required  to  solve  the  system  by  identifying  and 
characterizing  a  set  of  smaller  blocks  which  when  sequentially  solved,  determine  all 
of  the  system  variables.  The  system  structural  Jacobian  can  also  be  used  to  detect 
unconnected  systems  and  indicate  possible  potential  reference  problems. 

The  Systematic  Treatment  of  Waveforms  as  an  abstract  data  type 

WAVESEM  departs  from  the  conventional  paradigm  of  representing  variables  in 
a  dynamic  simulation  by  a  series  of  discrete  points  in  time  with  a  new  paradigm  based 
on  representing  variables  as  a  sequence  of  waveform  intervals.  Within  each 
waveform  interval,  the  value  of  the  waveform  can  be  directly  determined  for  any  time 
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based  on  a  vector  of  coefficients,  a  waveform  type  indicator  for  specifying  how  the 
vector  of  coefficients  should  be  interpreted,  and  the  time  boundaries  of  the  waveform 
interval.  Devices  are  defined  independent  of  the  waveform  type  of  the  terminal 
variables.  The  principle  advantage  of  using  waveforms  is  that  integration  and 
differentiation  are  simple  operators.  The  integral  of  a  waveform  is  just  another 
waveform.  Simulation  time  steps  are  no  longer  controlled  by  the  requirement  for 
numerical  stability  of  the  integration  technique.  Instead,  series  truncation  error 
control  becomes  the  primary  concern  of  the  simulation  environment.  The  ability  to 
use  arbitrary  waveform  types  and  convert  between  types  allows  the  modeler  to  use  the 
most  appropriate  waveform  representation  for  the  modeling  problem. 

This  thesis  is  composed  of  six  chapters  including  this  introduction.  Chapter  Two 
describes  in  some  detail  the  specific  properties  of  current  shipboard  electric  power  systems 
and  proposed  integrated  electric  drive  systems.  Chapter  Three  provides  a  framework  of 
theory  for  developing  the  simulation  environment  WAVESIM  and  is  broken  into  five 
subsections.  The  first  subsection  details  the  Terminal  Description  method  for  modelling 
devices.  The  second  subsection  demonstrates  how  to  interconnect  device  models  into 
systems,  construct  the  system  structural  Jacobian,  and  generate  a  sequence  of  blocks  for 
solving  the  system  equations.  The  third  subsection  covers  the  treatment  of  waveforms  as  an 
abstract  data  type.  Solving  the  system  of  equations  employing  waveforms  is  detailed  in  the 
fourth  subsection.  The  fifth  and  final  subsection  of  the  third  chapter  covers  modelling 
techniques  and  considerations  not  covered  in  previous  sections.  The  actual  WAVESIM 
implementation  of  the  concepts  developed  in  the  third  chapter  are  described  in  the  fourth 
chapter.  The  fifth  chapter  presents  results  of  several  simulations  conducted  with 
WAVESIM.  The  final  chapter  provides  an  assessment  of  the  work  presented  here  as  well  as 
possible  future  developments. 

The  appendices  support  the  main  chapters.  Appendix  A  is  a  glossary  of  terms  used 
through  out  this  thesis.  Appendix  B  details  some  possible  problems  with  using  continuation 
parameters.  Appendices  C  and  D  are  Load  Flow  examples  of  the  terminal  description 
method.  Appendix  E  provides  examples  of  waveform  types  and  a  number  of  operators  for 
them.  Appendix  F  presents  a  number  of  models  useful  for  conducting  shipboard  power 
system  simulations.  Finally,  Appendix  G  details  the  program  files  making  up  WAVESIM. 

This  thesis  introduces  a  number  of  new  terms.  To  assist  the  reader,  the  first  occurance 
of  a  new  term  is  indicated  by  the  distinctive  Helvetica  typeface.  MATLAB  variable  names 
and  sample  sections  of  C  programs  are  printed  in  Courier. 
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Chapter  2  Shipboard  Electric  Systems 
2.1  Typical  Shipboard  Electric  Distribution  System 

The  electric  power  systems  onboard  naval  warships  differ  considerably  from  the 
integrated  power  utilities  found  in  developed  countries.  The  differences  arise  from  the 
small  size  of  the  shipboard  systems  and  contrasting  standards  for  optimization.  Shipboard 
systems  are  optimized  for  survivability  and  minimization  of  weight  and  volume.  Power 
utilities  on  the  other  hand  optimize  for  reliability  and  minimization  of  cost.  The  unique 
characteristics  of  the  shipboard  systems  result  in  markedly  different  design  requirements 
and  standards  as  compared  to  power  utilities. 

Frigates,  destroyers  and  cruisers  are  relatively  small  warships  with  corresponding 
small  electric  power  systems.  Frigates  normally  displace  from  2000  to  4000  long  tons 
(1  long  ton  =  2240  lbs)  and  have  a  primary  mission  of  escorting  merchant  convoys.  In  the 
U.S.  Navy,  frigates  have  only  one  propulsion  shaft  and  about  half  the  armament  of  a 
destroyer.  Destroyers  displace  from  4000  to  7500  long  tons  and  are  designed  as  escorts  for 
aircraft  carrier  battle  groups.  Cruisers  are  larger  than  destroyers,  displacing  from  6000  to 
16000  long  tons,  carry  more  weapons,  and  are  used  to  provide  aircraft  carrier  battle  groups 
with  integrated  anti-aircraft  and  anti-cruise  missile  defenses.  U.S.  Navy  cruisers  and 
destroyers  all  have  two  propulsion  shafts. 

The  installed  electric  plant  capacity  for  U.S.  warships  has  varied  from  3000  KW  to 
4500  KW  per  propulsion  shaft  over  the  past  twenty  years.  Generally,  the  newer  ships  have 
more  installed  capacity.  Figure  2.1-1  shows  the  electric  plant  characteristics  for  the  major 
classes  of  conventionally  fueled  frigates,  destroyers  and  cruisers  constructed  in  the  past 
twenty  years.  All  the  listed  ships  with  the  exception  of  the  Knox  class  frigates  use 
mechanically  coupled  gas  turbine  propulsion.  The  Knox  class  frigate  is  the  last  class  of 
conventionally  fueled  warships  to  use  1200  psi  steam  for  main  propulsion.  (All  nuclear 
powered  ships  use  600  psi  steam).  Most  of  the  Knox  class  frigates  are  presently  being 
transferred  to  the  reserve  forces  or  being  decommissioned. 
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Figure  2.1-1  U.S.  Navy  Ship  Characteristics 


Ship  Class  (Nbr) 

Name 

KW 

Generator  Type 

Year 

FF-1052  Frigate 
(46) 

Knox 

4  x  750  KW 

3  Steam  Turbine 

1  Diesel 

1969 

FFG-7  Frigate 
(51) 

Oliver  Hazard 
Perry 

4x  1000 
KW 

4  Diesel 

1977 

DD-963  Destroyer 
(31) 

Spruance 

3x2000 

KW 

3  Gas  Turbine 

1975 

DDG-993  Destroyer 
(4) 

Kidd 

3x2000 

KW 

3  Gas  Turbine 

1981 

DDG-51  Destroyer 
(1  +  28) 

Arleigh  Burke 

3x3000 

KW 

3  Gas  Turbine 

1991 

CG-47  Cruiser 
(19  +  8) 

Ticonderoga 

"Aegis” 

3x2500 

KW 

3  Gas  Turbine 

1983 

Figure  2.1-2  Shipboard  Electric  Distribution  System 


Figure  2.1-2  shows  a  typical  ring  bus  architecture  found  on  modem  warships.  The 
small  size  of  the  shipboard  system  results  in  many  differences  with  respect  to  commercial 
systems.  As  a  consequence  the  analysis  of  the  shipboard  plant  requires  recognition  of  these 
differences: 

1 .  Power  Quality  requirements  relaxed  relative  to  commercial 

standards.  Constant  frequency  and  voltage  assumptions 
can  not  be  made.  See  section  2.2  for  more  details. 

2.  Very  little  Rotational  Inertia  require  fast  controls  to 

maintain  frequency.  Infinite  bus  assumption  does  not  hold. 

3.  Transmission  lines  are  very  short  and  for  the  most  studies, 

can  be  ignored. 

4.  No  scheduling  of  real  or  reactive  power.  All  generators 

are  loaded  in  equal  proportion  to  their  rating. 

Load  Flow  solution  has  little  meaning. 

5.  Load  sharing  information  communicated  to  all  online  generators. 

6.  Large  loads  (relative  to  the  size  of  generation  plant)  present. 

Start  up  transients  (load  dynamics)  are  important 

7.  Power  Electronic  Switching  loads  are  significant. 

8.  Load  shedding  strategies  are  minimal. 

Figure  2.1-2  also  indicates  the  requirement  for  a  simulation  environment  to  include 
the  ability  to  model  more  than  just  electric  power  phenomena.  Modelling  shipboard 
systems  also  requires  extensive  representation  of  mechanical  dynamics  as  well  as  energyless 
information  transfer  between  components.  This  requirement  is  significant  in  that  simulation 
packages  for  commercial  power  systems  do  not  include  this  capability  as  an  integral  part  of 
the  simulation  environment  design. 

2.2  Shipboard  Electric  Plant  Standards 

The  primary  standards  for  designing  a  shipboard  electric  plant  are  contained  in  the 
following  references: 

Department  of  Defense,  Interface  Standard  for  Shipboard  Systems,  Section  300A, 
Electric  Power,  Alternating  Current  (Metric),  MIL-STD-1399(NAVY),  13 
October  1987. 
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Department  of  the  Navy,  General  Specifications  for  Ships  of  the  United  States  Navy, 
Section  300,  General  Requirements  for  Electric  Plant,  Naval  Sea  Systems 
Command,  1987. 

Department  of  the  Navy,  General  Specifications  for  Ships  of  the  United  States  Navy, 
Section  320,  General  Requirements  for  Electric  Power  Distribution  Systems, 
Naval  Sea  Systems  Command,  1987 

The  goal  of  electric  power  utilities  is  to  provide  a  reliable  source  of  high  quality 
electric  power  at  minimum  cost.  Shipboard  systems  on  the  other  hand  are  designed  to 
provide  a  survivable  and  continuous  source  of  electricity.  Quality  and  cost  are  secondary 
issues.  Figure  2.2-1  summarizes  the  minimum  quality  of  power  a  shipboard  system  must 
provide 

Figure  2.2-1  clearly  demonstrates  the  quality  of  power  guaranteed  onboard  a  warship 
is  considerably  lower  than  the  quality  of  service  provided  by  power  utilities.  Figure  2.2-1 
does  not  show  however,  how  often  the  transient  conditions  occur.  This  information  is 
provided  by  MIL-STD-1399  and  summarized  in  figure  2.2-2.  A  major  ramification  of  the 
low  quality  of  power  provided  by  the  ship  service  electric  system  is  that  loads  must  be 
designed  to  operate  and  survive  wide  ranges  of  voltage  and  frequency  fluctuations.  This  is 
one  of  the  reasons  why  commercial  equipment  often  can  not  be  directly  installed  onboard 
ships  (Shock  requirements  are  also  a  major  factor).  Sensitive  loads  must  provide  their  own 
filtering  and  protection  circuitry.  This  militarization  of  equipment  can  add  considerable 
cost  and  complexity  to  warship  design,  outfitting  and  maintenance. 
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Figure  2.2-1  :  Shipboard  Electric  Power  Quality  Standards  (M3L-STD-1399) 

Frequency 

Nominal 

60  Hz 

Tolerance 

±3% 

Modulation1 

0.5% 

Transient  Tolerance 

±4% 

Transient  Recover  Time 

2  seconds 

Worst  Case  Excursion 

±  5.5  % 

|  Voltage  | 

Nominal 

440/115  Volts 

Tolerance  of  3  Phase  Ave 

+  5% 

Tolerance  of  any  1  Phase 

±7% 

Line  Voltage  Unbalance2 

3% 

Voltage  Modulation 

2% 

Transient  Tolerance 

±16% 

Maximum  Departure  Voltage  from 

±6% 

combination  of  3  Phase  Ave.  and 

Voltage  Modulation 

Worst  Case  Excursion 

±20% 

Recovery  Time 

2  Seconds 

Voltage  Spike3 

2500/ 1000  Volts 

|  Voltage  Waveform  f 

Max  Total  Harmonic  Distortion4 

3% 

Max  Single  Harmonic 

2% 

Max  Deviation  Factor5 

5% 

|  Emergency  | 

Frequency  Excursion 

-100  %  to  +12  % 

Voltage  Excursion 

-100  %  to  +35  % 

Duration 

2  Minutes 

1  Modulation  (percent)  =  — - 100  measured  over  a  period  of  1  to  10  seconds. 

2  Line  Voltage  Unbalance  is  the  difference  between  the  largest  line  to  line  voltage  and  the 
smallest  line  to  line  voltage  divided  by  the  nominal  voltage. 

3  A  Voltage  Spike  is  a  voltage  change  of  less  than  1  ms  duration. 

4  Total  Harmonic  distortion  is  the  ratio  of  the  rms  value  of  the  residue  (after  elimination  of 
the  fundamental)  to  the  rms  value  of  the  fundamental. 

5  Deviation  Factor  is  the  ratio  of  the  maximum  difference  between  corresponding  ordinates 
of  the  waveform  and  an  equivalent  sine  wave  to  the  magnitude  of  the  equivalent  sine  wave. 
The  equivalent  sine  wave  is  defined  as  having  the  same  frequency  and  rms  voltage  as  the 
wave  being  tested. 
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|  Figure  2.2-2  Shipboard  Electrical  Reliability  f 

Voltage  Transients  of  10%  or  less 
Voltage  Transients  of  10%  to  16% 
Voltage  Spikes  above  200  Volts 

Several  times  an  hour 

Several  times  a  day 

About  once  every  3  hours 

The  basic  reason  for  the  low  quality  of  power  onboard  ship  is  the  lack  of  rotational 
inertia  in  the  power  system.  In  the  commercial  sector,  the  inertia  of  all  the  generators  in  the 
network  add  up  to  such  a  large  number  that  no  single  fault  can  cause  a  frequency 
disturbance  system  wide.  Onboard  ship  however,  generators  are  often  operated 
independently.  Other  than  the  inertia  provided  by  motors,  the  only  source  of  rotational 
inertia  is  the  one  generator.  Since  the  generators  are  not  very  large,  sudden  load  changes 
and  faults  can  cause  significant  disturbances.  Although  speed  governors  and  voltage 
regulators  have  improved  significantly  in  the  past  twenty  years,  there  is  presently  no  way  to 
prevent  the  transients  from  happening. 

The  frequency  tolerance  limits  in  the  steady  state  are  rarely  ever  approached  in 
modem  warships.  The  rather  loose  tolerances  allowed  the  use  of  droop  governors  to  stably 
share  loads.  The  electric  plant  operator  on  older  ships  could  increase  the  load  on  a 
paralleled  generator  by  increasing  the  base  frequency  set  point  on  the  mechanical  speed 
governor.  Adjusting  the  system  frequency  without  changing  the  load  sharing  ratios  required 
adjusting  the  base  frequency  set  points  on  all  the  generator  speed  governors.  On  modem 
warships,  all  the  generators  normally  operate  isosynchronously  and  perform  load  sharing  by 
transmitting  load  current  information  to  Governor  Control  Units  which  provide  feedback  to 
the  Asynchronous  governors. 

2.3  Shipboard  Electric  Plant  Design 

In  the  commercial  sector,  the  design  of  electric  generation  and  transmission  capacity 
are  done  continuously.  Ships  on  the  other  hand,  have  a  finite  life  (typically  thirty  years)  and 
the  expense  of  upgrading  the  capacity  of  the  electric  plant  and  distribution  system  once  the 
ship  is  built  is  usually  prohibitive.  In  this  sense,  capacity  expansion  onboard  ships  is  not 
done.  Instead,  excess  capacity  is  initially  installed  to  account  for  projected  growth  in  load. 

The  maximum  load  for  a  ship  design  is  determined  by  tabulating  every  load  in  an 
Electrical  Load  Summary  and  summing  up  the  power  requirements  under  different 
operating  conditions.  The  maximum  projected  load  usually  occurs  when  the  ship  is  in  battle 
condition  and  the  ambient  temperature  is  low  (Electric  heaters  are  used  in  many  areas  of  a 
ship).  To  account  for  uncertainty  in  estimating  loads,  a  20  %  margin  is  added  to  the 
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maximum  projected  load.  Another  20  %  margin  is  added  for  capacity  expansion 
requirements.  Ninety  percent  of  the  capacity  of  all  but  one  of  the  installed  generators  must 
meet  or  exceed  the  margined  maximum  projected  load.  The  ninety  percent  requirement 
allows  for  imprecise  load  sharing  when  at  maximum  load  while  the  all  but  one  requirement 
accounts  for  taking  one  generator  off  line  for  maintenance. 

Figure  2.3-1 

U.S.  Ships  -  Electrical  Loads 
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Once  the  size  of  the  electric  plant  is  determined,  there  are  a  number  of  other 
considerations  that  must  be  accounted  for.  GENSPECS6  require  the  system  be  ungrounded 
and  based  on  Split  Plant  Operation  (Each  generator  operating  independently)  with  the 
capability  for  parallel  operation.  Electromagnetic  Interference  (EMI)  and  Electromagnetic 
Pulse  (EMP)  requirements  place  further  constraints  on  the  electric  plant  design  and  are 
detailed  in  MIL-STD-461  and  MIL-STD-1310.  Since  warships  are  designed  for  combat, 
they  must  also  be  capable  of  surviving  severe  mechanical  shocks  from  exploding  ordnance. 
The  shock  requirements  are  particularly  important  for  electrical  equipment  such  as  circuit 
breakers  and  generators.  Specific  requirements  for  shock  are  listed  in  MIL-STD-901. 


6  General  Specifications  for  Ships  of  the  Unites  States  Navy 
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A  number  of  loads  onboard  a  ship  are  very  important  for  survival  of  the  ship  and  crew 
during  combat  and  emergencies.  These  loads  are  designated  vital  loads  and  must  be 
provided  with  primary  and  alternate  sources  of  power.  Some  of  the  vital  loads  have 
automatic  bus  transfer  switches  (ABT)  which  switch  to  the  alternate  source  automatically 
on  loss  of  the  primary  source.  Others  use  manual  bus  transfer  switches  (MBT).  Examples 
of  vital  loads  include: 


Collective  Protection  System  Class  W 
Ventilation 

ABT 

Emergency  Communications 

MBT 

Emergency  Lighting 

ABT 

Fire  Pumps 

ABT 

AFFF  Pumps 

ABT 

Interior  Communications 

ABT 

Machinery  Space  Circle  W  Ventilation 

MBT 

Steering  Gear  Auxiliaries 

ABT 

Surface  Search  Radar 

MBT 

VHF  Bridge-to-Bridge  Radio 

MBT 

Vital  Propulsion  Auxiliaries 

MBT  and  ABT 

Auxiliaries  to  support  generator  prime 

MBT 

movers 


From  a  naval  architectural  viewpoint,  the  placement  of  electric  generators  requires  a 
number  of  compromises.  Placing  the  heavy  generators  as  low  as  possible  is  beneficial  for 
hydrostatic  stability  purposes.  The  lower  the  generator  however,  the  more  volume  is 
required  for  intake  and  exhaust  ducting.  Gas  turbine  generators  are  lighter  than  diesel 
generators,  but  require  greater  volumes  of  air.  Furthermore,  design  requirements  exist  for 
separating  50  %  of  the  installed  capacity  by  two  watertight  bulkheads  and  installing  a 
minimum  of  three  generators.  Generally,  weight  can  be  minimized  by  using  the  smallest 
number  of  generators  (three).  However,  if  four  generators  are  used,  the  generators  can  be 
located  in  two  machinery  spaces  instead  of  three.  By  using  only  one  set  of  intake  and 
exhaust  ducts,  volume  for  ductwork  can  also  be  reduced.  Since  most  recent  ships  have  had 
weight  constraints  placed  on  them  by  Congress,  the  minimum  number  of  generators  have 
been  used.7 


7  A  very  simple  cost  model  for  warships  assigns  a  cost  per  ton  of  different  components  of  a 
ship.  With  this  in  mind  Congress  has  in  the  past  placed  constraints  on  the  weight  of  ships  in 
order  to  keep  costs  down. 
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Enclaving  is  a  concept  for  arranging  ships  which  involves  locating  all  the  equipment 
required  for  a  given  combat  system  within  the  same  general  area  of  the  ship.  If  a  ship  is 
completely  divided  into  a  number  of  enclaves,  one  enclave  can  be  damaged  by  enemy 
ordnance  while  the  others  remain  functional  and  capable  of  continuing  the  engagement.  To 
work  properly,  this  concept  requires  the  enclaving  of  sources  of  distributed  services  (such  as 
electricity,  cooling  water,  fire  fighting  water  and  dry  air).  Presently,  enclaving  has  not  been 
incoiporated  in  any  warship  design  but  its  use  has  been  proposed  for  a  number  of  new 
designs8.  If  enclaves  are  ever  used,  they  will  have  a  significant  impact  on  the  type,  size, 
number,  and  location  of  electric  generators.  In  some  enclaves  it  may  not  even  be  possible  to 
locate  a  conventional  generator.  Alternate  generating  or  storage  devices  such  as  fuel  cells 
or  batteries  may  be  used. 

2.4  Integrated  Electric  Drive 

Most  modem  warships  mechanically  couple  the  main  propulsion  prime  movers  with 
the  propeller  shaft.  The  mechanical  power  train  is  very  efficient  but  imposes  constraints  on 
machinery  arrangement  and  adversely  impacts  survivability.  The  prime  mover  is  usually 
very  heavy  and  must  be  located  near  the  center  of  the  ship  to  prevent  excess  trim.  Shafting 
must  therefore  penetrate  a  number  of  watertight  boundaries  and  maintain  precise  alignment 
over  a  great  distance.  The  long  length  and  precision  requirements  of  the  shafting  make  it 
very  vulnerable  to  weapon  induced  damage.  While  eiectric  propulsion  eliminates  many  of 
the  survivability  and  arrangement  constraints  of  the  mechanical  system,  the  propulsion 
system  must  be  carefully  designed  to  ensure  overall  plant  efficiency  is  not  degraded  by  the 
extra  power  conversion  losses  in  converting  to  and  from  electric  power.  Designed  properly, 
an  electric  drive  system  can  achieve  the  survivability  and  arrangeability  benefits  without 
suffering  from  a  lower  propulsion  plant  efficiency. 

Integrated  electric  drive  interconnects  the  generation  of  power  for  propulsion  with  the 
generation  of  ship  service  electric  power.  The  propulsion  plant  for  U.S.  warships  typically 
averages  between  30  and  37.5  MW  per  shaft.  The  capacity  is  sized  to  provide  enough 
power  to  propel  the  ship  at  a  desired  maximum  speed.  Most  ships  however,  do  not  operate 
for  extended  periods  of  time  at  maximum  speed.  Operating  at  half  maximum  speed  requires 
only  about  20  percent  of  the  installed  power  and  quarter  maximum  speed  requires  only  2  or 


8  Enclaving  requires  a  greater  redundancy  of  equipment  which  results  in  the  ship  becoming 
larger  and  more  expensive.  Since  most  ship  designs  are  cost  constrained,  enclaving 
provisions  are  often  deleted  to  reduce  the  per  unit  price  of  the  warships. 
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3  percent.  Thus  a  28  knot  frigate  with  a  30  MW  plant  could  go  7  knots  using  less  than  1 
MW  of  power  and  14  knots  with  about  6  MW  of  power.  If  the  propulsion  plant  consists  of 
two  15  MW  generators,  one  generator  could  easily  supply  all  the  required  power  for  both 
propulsion  and  ship  service  at  the  normal  operating  speeds  of  12  to  15  knots.  This  has  the 
potential  of  reducing  the  fuel  consumption  of  warships  under  normal  operating  conditions 
by  improving  the  overall  efficiency  of  the  power  plant  even  though  the  efficiency  of  the 
power  transmission  system  is  lower.  By  careful  selection  ot  generator  number  and  size,  one 
can  tune  the  overall  efficiency  of  a  plant  for  optimization  at  several  different  speeds.  In  the 
U.S.  Navy,  optimizing  plant  efficiency  for  20  knots  is  beneficial  since  this  is  the  speed  used 
to  calculate  the  amount  of  fuel  carried  by  the  ship.9 

In  a  typical  integrated  electric  drive  scheme,  the  propulsion  prime  movers  are 
connected  to  both  a  propulsion  generator  and  to  a  ship  service  generator  (PDSS  or 
Propulsion  Derived  Ship  Service).  The  speed  of  the  generator  is  set  to  optimize  efficiency 
of  the  prime  mover  at  the  given  power  loading.  Consequently,  cycloconverters  are  used  to 
convert  the  power  to  either  60  Hz  for  ship  service,  or  to  whatever  frequency  the  propulsion 
motors  require.  Usually,  an  additional  diesel  or  gas  turbine  ship  service  generator  is 
included  to  provide  power  in  port  or  during  emergencies.  Figure  2.4-1  shows  a  typical 
PDSS  design  for  a  two  shaft  frigate  sized  ship. 

Figure  2.4-1  emphasizes  the  need  to  model  mechanical  dynamics  and  control 
information  signals.  The  control  signals  can  couple  the  dynamics  of  different  devices 
within  the  system  and  must  therefore  be  carefully  modelled.  The  control  signals  can  also 
destroy  such  properties  as  diagonal  dominance  which  makes  analysis  of  commercial  power 
systems  much  easier. 

One  of  the  features  of  an  electric  drive  system  which  may  be  exploited  in  the  future  is 
the  ability  to  divert  all  of  the  propulsion  power  capacity  from  propulsion  to  some  sort  of 
high  power  combat  system.  Weapons  such  as  rail  guns  and  high  energy  lasers  may  become 
possible.  These  types  of  weapons  would  be  safer  for  the  ship  since  the  requirement  to  store 
large  amounts  of  chemical  explosives  for  propellent  charges  would  be  reduced.  Energy  to 
move  projectiles  would  be  stored  in  the  form  of  relatively  inert  fuel  oil  instead  of  highly 


9  Most  other  navies  use  18  knots  which  allows  for  combined  plants  such  as  CODOG  where  a 
diesel  engine  is  used  for  cruising  and  a  gas  turbine  for  high  speed.  Unfortunately,  the  size 
requirement  for  a  diesel  capable  of  propelling  a  ship  at  20  knots  is  prohibitive  and  results  in 
U.S.  warships  only  using  gas  turbines  and  carrying  much  more  fuel. 
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Figure  2.4-1  Integrated  Electric  Drive 


explosive  chemical  propellents.  Switching  large  amounts  of  electric  power  onboard  ships 
presents  a  number  of  technical  challenges  both  in  the  design  of  physical  equipment  and  also 
in  attempts  to  accurately  simulate  the  phenomena.  The  effect  of  pulse  loads  on  the  electric 
system  is  not  a  trivial  simulation  problem. 
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Chapter  3  Framework 

Conducting  time  domain  simulations  of  systems  of  nonlinear  lumped  parameter  models 
characterizing  shipboard  electric  power  systems  requires  an  organized  approach  to 
developing  device  models  as  well  as  network  equations.  The  major  contribution  of  this 
thesis  is  the  development  of  a  simulation  environment  having  the  following  properties: 

1.  An  object  oriented  approach  to  developing  the  mathematical  description  of  devices 

independent  of  the  manner  in  which  the  variables  are  represented. 

2.  An  organized  method  for  generating  system  equations  for  interconnecting  device 

models  into  subsystems  and  systems. 

3.  An  algorithm  for  solving  the  system  equations  and  variables  by  identifying  smaller 

blocks  of  equations  and  variables  which  can  be  sequentially  solved.  The 
algorithm  develops  the  concept  of  the  device  structural  jacobian  matrix  and  the 
system  structural  jacobian  matrix. 

4.  The  ability  to  use  a  wide  range  of  methods  to  describe  variable  waveforms.  In 

particular,  describing  waveforms  through  vectors  of  coefficients  of  polynomial 
series,  orthogonal  function  series,  and  data  series  are  stressed. 

5.  The  ability  to  solve  the  system  of  equations  by  employing  either  the 
Newton-Raphson  Method  or  Waveform  Relaxation.  The  Newton-Raphson 
method  is  modified  to  improve  convergence  properties  through  the  use  of 
continuation  methods. 

This  chapter  is  organized  into  five  parts.  The  first  part  defines  the  device  which  is  the 
fundamental  building  block  of  the  system  simulation.  The  second  part  shows  how  to 
interconnect  several  device  models  into  systems  and  subsystems.  The  third  part  defines  the 
waveform  as  a  vector  of  coefficients  to  approximate  waveforms  over  time  intervals.  The 
fourth  part  details  the  actual  procedure  for  conducting  a  simulation.  The  fifth  and  final  part 
details  some  finer  points  which  should  be  considered  when  constructing  models. 
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3.1  Device  Description 

A  Device  Description  is  an  organized  manner  for  describing  the  characteristics  of 
a  physical  component.  This  description  includes  definitions  of  variables  which  interface 
with  other  components  in  a  system,  variables  called  states  which  allow  for  information 
storage,  and  constitutive  relations  describing  the  device  behavior. 

3.1.1  Interface  Variables 

The  interface  variables  are  defined  as  either  potential  variables  or  flow 
variables  depending  on  their  interaction  with  the  interface  variables  of  other  devices 
within  a  system  or  subsystem.  Systems  and  subsystems  are  constructed  by  grouping 
the  interface  variables  of  one  or  more  devices  into  sets  called  nodes  and  applying 
network  equations  determined  by  the  types  of  variables  attached  to  the  nodes. 

All  potential  variables  attached  to  a  node  are  equated  to  a  potential  value 
associated  with  the  node.  Physical  quantities  which  can  be  classified  as  potentials  include 
voltages,  signal  levels,  rotational  speeds,  deflections,  and  pressures.  All  potentials  are 
referenced  to  0.  All  potential  variables  connected  to  the  same  node  must  be  defined  with 
respect  to  the  same  system  wide  reference  level.  In  other  words,  0  must  mean  the  same 
thing  for  all  of  the  potentials  attached  to  a  given  node. 

The  sum  of  all  flow  variables  attached  to  a  node  is  equated  to  zero.  Physical 
quantities  analogous  to  flow  variables  include  currents,  power  flows,  torques,  forces  and 
mass  flow  rates. 

3.1.2  Terminals 

Terminals  provide  a  mechanism  for  organizing  the  interface  variables  of  a  device. 
In  general,  there  are  two  types  of  terminals:  Normal  Terminals  and  Information 
Terminals. 

A  normal  terminal  has  associated  with  it  a  flow  variable  and  a  potential  variable. 
Its  electrical  analog  is  one  of  the  wiring  terminals  on  an  electrical  device.  A  mechanical 
analog  is  the  rotating  shaft  coupling  of  a  gearbox.  The  equations  for  exchanging  energy 
between  devices  can  be  generated  through  the  list  of  normal  terminals  connected  together 
at  a  given  node. 
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An  information  terminal  has  associated  with  it  only  a  potential  variable.  The 
potential  variable  is  used  to  convey  knowledge  between  devices  without  transferring 
energy.  Set  points,  meter  readings,  and  control  signals  are  all  examples  of  energyless  data 
which  can  be  conveyed  through  information  terminals. 

All  normal  terminals  have  an  associated  KQL  Group  number.  A  KCL  group  is  the 
smallest  subset  of  a  device’s  terminals  such  that  the  sum  of  the  flow  variables  within  the 
subset  is  identically  zero  for  at  least  one  of  the  possible  dynamic  configurations  of  the 
device.  Normal  terminals  which  can  not  be  associated  with  a  KCL  group  are  given  a  group 
number  of  0.  The  remaining  terminals  are  assigned  the  group  number  of  their  parent  KCL 
group. 

The  KCL  Group  number  is  used  to  detect  possible  reference  frame  problems  within  a 
simulation  network.  A  given  electrical  circuit  problem  for  example,  must  have  at  least  one 
normal  terminal  with  a  0  group  node  within  a  given  independent  system  to  ensure  the  set 
of  system  KCL  equations  is  not  singular.  Normally  this  terminal  is  associated  with  a  one 
terminal  device  with  an  export  potential  and  import  flow  which  is  used  to  specify  the  value 
of  a  given  reference  node  potential.  This  Reference  Frame  Check  is  discussed  in  greater 
detail  in  section  3.2.4. 

Some  devices  may  have  variable  numbers  of  KCL  Groups  depending  on  the 
operating  point  of  the  device.  A  simple  model  of  a  two  terminal  switch  for  example, 
would  have  1  KCL  group  when  the  switch  is  closed  (the  sum  of  the  currents  entering  the 
switch  is  identically  zero)  and  2  KCL  groups  when  the  switch  is  open  (both  flow  variables 
are  identically  zero).  For  the  purpose  of  defining  the  device,  the  worst  case  in  terms  of 
creating  singular  systems  should  be  used.  In  the  switch  example,  each  terminal  should 
have  their  own  KCL  group  number  for  a  total  of  two  KCL  groups. 

3.1.3  Variable  Direction:  Import  and  Export  Variables 

The  Interface  variables  can  further  be  classified  by  whether  they  are  a  resource 
(Import)  or  product  (Export)  of  the  device  description.  A  device  description  can  be 
considered  a  means  for  generating  export  variables  based  on  the  values  of  the  import 
variables,  states,  parameters,  continuation  parameter,  and  time. 

An  import  variable  is  taken  as  input  by  the  device  description.  An  import  variable 
can  be  any  interface  variable  associated  with  either  normal  or  information  terminals.  To 
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ensure  a  consistent  set  of  equations  when  several  devices  are  connected  together  in  a 
system,  the  total  number  of  import  variables  associated  with  normal  terminals  must  equal 
the  number  of  normal  terminals 

An  export  variable  is  explicitly  defined  and  considered  a  product  of  the  device 
description.  An  export  variable  can  be  any  interface  variable  associated  with  either  normal 
or  information  terminals.  To  ensure  a  consistent  set  of  equations  when  several  devices  are 
connected  together  in  a  system,  the  total  number  of  export  variables  associated  with 
normal  terminals  must  equal  the  number  of  normal  terminals. 

3.1.4  States 

States  are  variables  whose  values  are  stored  for  a  given  time  for  later  use.  States 
can  be  used  for  example,  to  store  the  constant  of  integration  for  a  dynamic  equation.  States 
can  also  be  used  to  store  the  operating  mode  for  a  given  device.  In  general,  if  the  value  of 
a  given  variable  depends  on  the  previous  value  of  another  variable,  that  other  variable  is  a 
state. 

3.1.5  Parameters 

Parameters  are  constants  which  specify  characteristics  of  the  device  or  in  other 
words,  customizes  a  given  device  description  to  represent  a  given  physical  device.  A 
model  of  a  resistor  for  example,  includes  a  parameter  for  resistance.  This  precludes  the 
requirement  to  develop  a  model  for  every  resistor  value.  We  only  need  construct  a  generic 
resistor  model  instead  of  a  10K  resistor  model,  a  22K  resistor  model,  etc. 

3.1.6  Constitutive  Equations 

The  constitutive  equations  are  a  consistent  set  of  equations  for  specifying  the 
values  of  the  states  and  export  variables.  In  general,  the  number  of  constitutive  equations 
needed  is  equal  to  the  number  of  normal  terminals  plus  the  number  of  export  variables 
associated  with  information  terminals.  The  total  number  of  import  variables  associated 
with  normal  terminals  and  the  total  number  of  export  variables  associated  with  normal 
terminals  must  independently  equal  the  number  of  normal  terminals.  There  is  no 
constraint  on  the  number  of  import  variables  associated  with  information  terminals. 


-46- 


3.1.7  Device  Jacobian  Matrices 


A  Device  Jacobian  Matrix  provides  the  sensitivities  (partial  derivatives)  of  the 
export  variables  with  respect  to  the  import  variables.  This  implies  there  is  a  given 
ordering  of  both  the  import  X,  and  export  XE  variables: 
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The  Device  Jacobian  Matrix  is  used  to  generate  a  consistent  set  of  import  variables 
which  simultaneously  satisfy  the  device  constitutive  equations  along  with  constraints 
imposed  by  the  connections  of  terminals  to  nodes.  From  the  device  point  of  view  however, 
the  Jacobian  matrix  is  merely  a  product  that  must  be  computed. 

Up  to  this  point,  we  have  not  discussed  the  manner  in  which  the  variables  are 
described.  If  the  variables  are  represented  by  real  numbers,  then  each  element  of  the 
Jacobian  is  also  a  real  number.  If  instead  the  variables  are  represented  by  vectors,  then  the 
Jacobian  elements  will  be  matrices. 

3.1.8  Device  Structural  Jacobian  Matrix 

The  Device  Structural  Jacobian  Matrix  describes  the  properties  of  the  elements 
of  the  device  Jacobian  matrix  for  a  given  type  of  variable  representation  without  actually 
providing  any  values.  The  following  codes  can  be  used  to  describe  the  properties  of  the 
matrix  elements  of  the  device  Jacobian  matrix: 


I  Code 

Type  of  Matrix 

0 

Zero  Matrix  (all  elements  are  always  zero) 

I 

Identity  Matrix  (always  the  identity  matrix) 

D 

Diagonal  Matrix  (always  a  linear  main  diagonal  matrix) 

L 

Linear  Matrix  (The  elements  are  always  constant) 

A 

Nonlinear  AC  Matrix  (see  Note  3. 1.8-1) 

N 

Nonlinear  Matrix  (The  elements  may  not  be  constants)  | 

U 

Unknown  (The  dependence  is  unknown  (treat  as  nonlinear)) 

Note  3. 1.8-1:  An  AC  Matrix  is  one  for  which  the  constant  component  of  the  export 
variable  depends  only  on  the  constant  component  of  the  import  variable.  The  other 
components  of  the  export  variable  can  not  depend  on  the  constant  component  of  the 
import  variable  but  are  not  restricted  in  any  other  way. 

The  device  structural  Jacobian  matrix  is  useful  in  developing  the  algorithm  for 
generating  a  consistent  set  of  import  variables  without  having  to  deal  directly  with  the 
potentially  much  larger  device  Jacobian  matrices.  If  an  iterative  solution  scheme  is  used  to 
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develop  the  consistent  set  of  import  variables,  the  device  structural  Jacobian  matrix 
indicates  directly  which  matrix  elements  must  be  recalculated  for  each  iteration.  (Only  the 
nonlinear  and  unknown  elements  have  values  which  change  between  iterations) 

3.1.9  Continuation  Parameter 

A  system  containing  one  or  more  nonlinear  devices  may  be  difficult  to  solve  with  an 
iterative  method.  The  region  of  convergence  around  the  solution  may  be  so  small  as  to 
make  the  probability  of  success  for  choosing  a  starting  point  for  the  iterative  scheme 
almost  zero.  One  method  for  enlarging  the  region  of  convergence  is  through  the  use  of  a 
continuation  parameter  which  varies  from  0  to  1.  When  the  continuation  parameter 
has  value  1,  the  export  variables  are  developed  using  the  normal  nonlinear  constitutive 
equations.  When  the  continuation  parameter  has  value  0  however,  the  export  variables  are 
developed  using  a  linear  set  of  constitutive  equations.  As  the  continuation  parameter 
increases  from  0  to  1,  the  export  variables  traverse  a  continuous  path  from  the  linear 
solution  to  the  nonlinear  solution.  One  common  method  for  generating  such  a  dependence 
on  a  continuation  parameter  a  is: 

F(X,a)  =  aFH(X)  +  (l-a)F,(X) 

where  Fm(X)  is  the  nonlinear  function  for  generating  the  export  variables,  F, (X)  is  the 
linear  function  approximation,  and  F(X,a)  is  the  function  for  determining  the  export 
variables  for  intermediate  values  of  a.  Section  3.4.2  describes  in  detail  continuation 
parameters  in  relation  to  the  Newton-Raphson  method. 

3.1.10  Discontinuity  Time  Prediction 

If  the  variables  are  described  as  a  waveform  over  a  given  time  interval  [t^t ,] 
knowledge  of  the  time  of  discontinuities  can  prove  useful  to  the  algorithm  which  generates 
the  consistent  set  of  import  variables.  The  accuracy  of  a  vector  description  of  a  waveform 
often  deteriorates  greatly  if  there  is  a  discontinuity  during  the  time  interval.  Varying  f, 
such  that  it  falls  on  a  discontinuity  will  often  improve  the  accuracy  of  the  waveform 
representation.  For  this  reason,  each  device  has  the  opportunity  to  recommend  a 
recalculation  time  for  the  current  interval.  Normally,  the  system  would  use  the  minimum 
recommended  recalculation  time  offered  by  any  of  the  devices  to  recompute  the  time 
interval. 
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3.2  Network  Description 

A  network  is  composed  of  a  system  of  devices  and  subsystems  whose  terminals 
are  interconnected  at  nodes.  The  network  is  a  closed  system  having  no  terminals  defined 
for  any  of  its  nodes.  A  subsystem  is  a  system  having  terminals  defined  for  at  least  one  of 
its  nodes  and  therefore  can  not  be  solved  independently  of  other  devices  or  subsystems. 

3.2.1  Nodes 

A  node  connects  together  one  or  more  terminals  from  one  or  more  devices.  The 
nodal  connections  are  the  means  by  which  devices  are  combined  to  form  systems  (both 
networks  and  subsystems).  The  nodes  provide  the  association  of  device  import  and  export 
variables  with  system  variables  through  nodal  aquations.  Each  node  is  assigned  a 
serial  number  for  identifying  it  from  the  other  nodes.  There  are  two  types  of  Nodes: 
Normal  Nodes  and  Information  Nodes 

3.2.1.1  Normal  Nodes 

A  Normal  Node  has  at  least  one  normal  terminal  attached  to  it.  Information 
terminals  can  be  associated  with  the  node  as  long  as  none  of  the  information  terminal 
potentials  are  defined  as  an  export  variable.  A  normal  node  has  associated  with  it  a  node 
potential  as  well  as  a  Kirchhoff  Current  Law  (KCL)  equation.  The  number  of  normal 
nodes  is  designated  by  nm. 

In  a  subsystem,  a  normal  node  can  also  have  associated  with  it  a  terminal  for 
connecting  with  other  subsystems  and  devices.  This  terminal  can  be  either  a  normal 
terminal  having  an  associated  terminal  potential  and  flow  variable  or  an  information 
terminal  having  only  an  export  potential.  ( import  and  export  refer  here  to  the  direction 
relative  to  the  defining  subsystem  which  is  opposite  to  the  normal  definition  which  is 
relative  to  the  components  of  the  subsystem).  The  total  number  of  normal  node  normal 
terminals  defined  for  a  subsystem  is  designated  n^.  For  any  given  subystem  the  number 
of  normal  node  terminal  export  variables  and  import  variables  must  both  independently 
equal  n The  total  number  of  normal  node  information  terminals  is  designated  nHi. 

3.2.1.2  Information  Nodes 

An  Information  Node  has  only  information  terminals  attached  to  it.  Furthermore, 
one  and  only  one  of  the  terminal  potential  variables  must  be  an  export  variable.  Only  a 
node  potential  is  associated  with  an  information  node.  Information  nodes  work  in  the 
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same  manner  as  hooking  up  stereo  componenents:  you  can  hook  up  as  many  inputs 
(import  variables)  as  you  want  to  any  given  output  (export  variable),  but  should  never 
hook  up  two  or  more  outputs  together.  The  number  of  information  nodes  is  designated  by 

As  an  option  for  subsystems,  an  information  node  can  have  associated  with  it  an 
information  terminal  for  connecting  with  other  subsystems.  Since  the  meanings  of  import 
and  export  are  once  again  reversed  for  this  terminal,  no  other  export  potentials  from  other 
devices  or  subsystems  may  be  attached  to  the  node  if  the  information  terminal  potential  is 
an  import  variable.  If  the  information  terminal  potential  is  an  export  variable,  exactly  one 
other  export  potential  from  other  devices  or  subsystems  may  be  attached  to  the  node.  The 
total  number  of  information  node  information  terminals  is  designated  nm. 

3.2.2  System  Variables 

System  variables  comprise  the  minimum  set  of  variables  from  which  all  of  the 
device  import  and  export  variables  can  be  derived  from.  The  set  of  system  variables  is 
composed  of  node  potentials  as  well  as  all  device  import  flow  variables  and  normal  node 
normal  terminal  export  flow  variables.  For  a  subsystem,  the  node  terminal  import 
variables  are  assumed  to  be  provided  by  the  encompassing  system  or  subsystem  and  are 
not  considered  system  variables. 

3.2.2.1  Node  Potentials 

All  of  the  node  potentials  of  the  normal  and  information  nodes  are  system  variables 
which  must  be  solved  for.  Hence  there  are  a  total  of  nf  =  n„  +  n,  node  potentials. 

3.2.22  System  Flow  Variables 

All  of  the  Import  Flow  Variables  of  the  various  devices  making  up  the  system  as 
well  as  the  export  flow  variables  of  the  normal  node  terminals  are  system  variables.  The 
number  of  system  flow  variables  is  designated  by  rtf. 

3.2.3  System  Equations 

3.2.3.1  Kirchhoff  Current  Law  Equations 

Kirchhoff  s  current  law  states  the  sum  of  the  flow  variables  entering  a  node  is  equal 
to  zero.  For  a  given  normal  node  or  normal  terminal  node,  this  law  is  expressed  by 
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generating  a  list  of  the  terminals  of  the  various  devices  and  subsystems  attached  to  the 
node.  The  number  of  Kirchhoff  Current  Law  equations  is  equal  to  the  number  of  normal 
nodes  nm. 


ffl=ZI,  =  0 


where 

ff)  KCL  Equation  for  node  j  (Should  Equal  Zero) 

n,  Number  of  normal  terminals  attached  to  node 

Ij,  Flow  Variable  associated  with  rth  normal  terminal  attached  to  node  j 

3.2.32  Potential  Difference  Equations 

A  Potential  Difference  Equation  is  created  for  each  of  the  export  potential 
variables  of  the  various  devices  and  other  subsystems  and  for  each  of  the  import  potential 
variables  of  the  node  terminals.  This  equation  merely  states  the  difference  between  the 
node  potential  and  the  potential  variable  is  zero.  This  equation  is  expressed  by 
generating  a  list  of  the  terminals  of  the  various  devices  and  subsystems  attached  to  the 
node  having  an  export  potential  variable.  Since  one  and  only  one  export  information 
potential  can  be  assigned  to  an  information  node  and  can  never  be  attached  to  a  normal 
node,  the  number  of  potential  equations  due  to  export  information  potentials  is  simply  nt. 
The  requirement  for  a  device  to  have  equal  number  of  import  and  export  variables 
associated  with  normal  terminals  forces  the  number  of  export  normal  potentials  to  be  nf. 
Hence  the  total  number  of  potential  equations  is  nr  =  n,  +  ny. 

40  =  Vv,t  =  0 

where 

yj,()  Potential  Difference  Equation  for  node  j  export  potential  variable  i 

(Should  Equal  Zero) 

Vj  Node  j  Potential 

Vj,  rth  export  potential  variable  associated  with  node  j. 
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3.2.3.3  R^,,  and  G 


One  method  for  preventing  linear  dependences  among  the  system  equations  is  to 
modify  the  equations  to  include  an  extra  term  corresponding  to  either  a  small  conductance 
Gmln  to  the  ground  potential  for  KCL  equations  or  a  small  series  resistance  Rmh  for  the 
potential  difference  equations.  The  KCL  equation  is  now  given  by: 

/Jo=c„v',+  i/,=o 

I  ■  1 

The  potential  difference  equation  is  similarly  modified: 

fJ,Q  =  Vj-vJI-RaJl,=0 

The  goal  in  using  G^,  and  R^  is  to  reduce  the  condition  number  of  the  system 
Jacobian  matrix  to  the  point  where  the  system  can  reliably  be  solved  (A  singular 
matrix  has  an  infinite  condition  number).  G ^  and  R^,  can  also  add  fictitious  dynamics 
to  the  system  and  thereby  lead  the  simulation  to  produce  incorrect  results.  Hence  if  used, 
G ^  and  R^  should  be  large  enough  to  bring  the  condition  number  down  to  a  reasonable 
level,  but  small  enough  to  prevent  their  inclusion  from  having  appreciable  effect  on  the 
simulation  results. 

In  general,  the  use  of  Gw,  and  should  be  avoided  for  these  reasons: 

1.  G ^  and  R^m  are  fictitious  elements.  If  either  is  significant,  they  should  be 
explicitly  included  as  a  device. 

2.  The  indiscriminite  use  of  G*,.  and  R^  adds  to  the  complexity  of  the  system 
and  decreases  the  degree  to  which  the  system  can  be  reduced  into  smaller  blocks. 
In  other  words  the  inclusion  of  Gw.  and  may  greatly  increase  the  computation 
time. 

G,^,  and  are  included  in  WAVES IM  for  these  reasons 

1.  G ^  and  R^,  can  be  selectively  specified  for  individual  nodes.  If  a  simulation 
fails  to  converge  for  one  reason  or  another,  G ^  and  R^  can  be  employed  to  find 
the  part  of  the  system  experiencing  difficulties.  G^  and  are  excellent 
debugging  tools. 
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2.  Since  effectively  connects  the  node  to  the  ground  potential,  G^,  can  be 
used  to  ensure  all  of  the  nodes  have  the  same  potential  reference  and  ensure  there 
are  no  linear  dependent  KCL  equations. 
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3.2.4  Reference  Frame  Testing 


If  a  given  set  of  a  system’s  normal  nodes  can  be  found  such  that  all  terminals 
attached  to  any  of  its  nodes  have  nonzero  KCL  groups  and  such  that  if  a  terminal  is 
attached  to  one  of  the  set’s  nodes,  then  all  of  remaining  terminals  of  the  parent  KCL  group 
are  also  attached  to  one  of  the  nodes  of  the  set,  then  there  exists  the  possibility  of  a  singular 
system  due  to  the  1.  ear  dependence  of  the  KCL  equations  for  the  set  of  normal  nodes. 

If  <5^,  is  non-zero  for  a  node,  it  should  be  considered  a  terminal  with  a  0  KCL 
Group.  If  G ^  is  zero,  it  should  be  ignored. 

Testing  for  a  possible  singular  system  can  be  accomplished  with  the  following 
algorithm: 

1.  Set  all  the  normal  node  circuit_group_indicators  to  0. 

Set  the  circuit_group_counter  to  0 

Set  the  circuit_group_singular_f lag  to  0 

2.  Start  with  the  first  normal  node  having  a  0  circuit_group_indicator 

If  none  can  be  found  then  algorithm  is  complete. 

Increment  circuit_group_counter. 

3.  Change  the  circuit_group_indLicator  of  the  node  to  the 

circuit_group_counter. 

4.  For  each  terminal  attached  to  the  node: 

4a.  If  the  KCL  group  number  is  zero,  set  the 

circuit_group_singular_f lag  to  1. 

4b.  If  the  KCL  group  number  is  nonzero,  loop  through  each  normal 
terminal  of  the  device.  If  the  terminal  belongs  to  the  same 
KCL  group  and  the  node  the  terminal  is  attached  to  has  a 
0  circuit_group_indicator,  then  set  the  node 
circuit  group_indicator  to  the  negative 
of  the  circuit_group_counter. 

5.  Search  all  of  the  nodes  for  a  negative  circuit_group_indicator 

If  none  can  be  found  and  the  circuit_group_singuiar_f  lag  is  zero 
Warn  user  that  a  singular  system  may  exist  with  the  group  nodes. 

If  none  can  be  found  then  go  to  step  2 
If  one  is  found,  then  go  to  step  3 
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Setting  a  proper  reference  for  each  such  set  of  system  nodes  can  be  accomplished  by 
attaching  to  one  of  the  nodes  a  one  terminal  device  having  the  following  characteristics: 

3.2.4. 1  Reference  Device 


Interface  Variables 

Terminal  Potential  Variable  Flow  Variable 

Ref  V  (export)  I  (import) 

Parameters 

Vlltf  Reference  Potential  Level 

Equations 

y=vKrf 

Device  Structural  Jacobian 


JDS  =  [0] 


(KCL  Grp)  Type 
(0)  Normal 


Device  Jacobian 


JD  =  [  0] 


Notes 

Most  conventional  circuit  simulations  define  a  reference  node  for  which  a  potential 
is  defined  and  the  KCL  equation  is  not  written.  Adding  this  reference  device  to  a  node 
effectively  converts  that  node  to  a  reference  node  in  the  usual  senses.  While  it  is  true  that 
the  KCL  equation  and  an  additional  Potential  Difference  equation  are  still  written  for  this 
reference  node,  each  is  part  of  a  one  element  block.  The  potential  difference  equation  can 
be  solved  before  the  simulation  starts  since  it  does  not  depend  on  any  of  the  system 
variables.  The  flow  variable  on  the  other  hand,  only  appears  in  the  KCL  equation  of  the 
one  node  and  thus  can  be  solved  after  all  the  other  system  variables  have  been  found.  In 
fact,  the  flow  variable  should  normally  equal  zero  if  the  rest  of  the  circuit  is  indeed 
linearly  dependent. 

As  a  convenience  to  the  user,  WAVESEM  automatically  attaches  a  reference  device 
with  v«f=  o  to  the  node  with  serial  number  0  if  that  node  is  used. 
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3.2.5  System  Reduction 


The  previous  sections  detail  a  method  for  generating  a  full  set  of  system  variables 
and  system  equations.  The  total  number  of  system  variable  equals  n^=  nH  +  n,  +  nf  which 
also  equals  the  number  of  system  equations.  For  even  a  small  system  the  algebraic  order 
n,f  can  become  quite  large.  For  this  reason,  elminating  system  variables  and  equations 
through  system  reduction  is  desirable.  The  primary  tool  for  performing  system  reduction 
is  the  system  structural  Jacobian. 

3.2.5.1  System  Structural  Jacobian 

The  System  Structural  Jacobian  facilitates  the  reduction  of  the  algebraic  order 
of  the  system  by  showing  the  nature  of  the  dependence  of  system  equations  to  each  of  the 
system  variables.  The  System  Structural  Jacobian  is  constructed  by  combining  elements 
of  the  device  structural  Jacobian  matrices  according  to  the  arithmetic  of  structural 
Jacobian  elements.  The  types  of  elements  in  the  system  structural  Jacobian  is  given  by: 


|  Code 

Type  of  Matrix 

0 

Zero  Matrix  (all  elements  are  always  zero) 

!  1 

Identity  Matrix  (always  the  identity  matrix) 

D 

Diagonal  Matrix  (always  a  linear  main  diagonal  matrix) 

1  L 

Linear  Matrix  (The  elements  are  always  constant) 

S  A 

Nonlinear  AC  Matrix  (see  Note  3.2. 5. 1-1) 

N 

Nonlinear  Matrix  (The  elements  may  not  be  constants) 

U 

Unknown  (The  dependence  is  unknown  (treat  as  nonlinear)) 

Note  3.2.5. 1-1:  An  AC  Matrix  is  one  for  which  the  constant  component  of  the  export 
variable  depends  only  on  the  constant  component  of  the  import  variable.  The  other 
components  of  the  export  variable  can  not  depend  on  the  constant  component  of  the 
import  variable  but  are  not  restricted  in  any  other  way. 

The  addition  and  subtraction  operators  for  the  structural  Jacobian  elements  is  a 
function  of  the  manner  in  which  the  system  variables  are  represented.  For  all  of  the 
methods  used  in  this  thesis,  the  following  definitions  apply: 
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I  +  I  =  D 
1-1  =  0 
I±0  =  I 
-I±0  =  D 
•I  -I  =  D 

±n±m  =  ±m  ±n  =  n  ( n>m ,  n*I) 

U>N>A>L>D>I>  0 

Note,  the  Identity  Code  I,  is  not  strictly  necessary  and  if  eliminated  simplifies  the 
addition  and  subtraction  operators  to: 

±n±m  =  ±m  ±n  =  n  ( n>m ) 

Before  the  system  structural  jacobain  can  be  constructed,  the  system  variables  and 
equations  must  be  ordered.  The  first  np  variables  are  the  node  potentials  of  the  normal 
and  information  nodes  arranged  in  the  order  of  the  node  serial  numbers.  The  next  nf 
variables  are  the  import  flow  variables  ordered  first  by  device  then  by  device  terminal. 
The  first  n„  equations  conform  to  the  Kirchhoff  Current  Law  equations  for  the  normal 
nodes  arranged  in  order  of  the  node  serial  numbers.  The  remaining  n,  equations  are  the 
potential  equations  for  the  export  potentials  ordered  first  by  the  node  serial  number  they 
are  attached  to,  then  by  the  order  of  the  devices  attached  to  the  node,  and  finally  by  the 
order  of  the  terminals  in  the  device. 

The  system  structural  Jacobian  is  constructed  in  two  parts  after  being  initialized  to 
contain  only  0.  First,  a  Kirchhoff  Current  Law  equation  is  generated  for  each  normal 
node.  The  normal  terminals  of  the  normal  nodes  are  examined  one  at  a  time.  If  the  flow 
variable  is  an  import  variable,  it  is  also  a  system  variable  and  an  /  is  added  to  the 
corresponding  element  of  the  system  Jacobian  matrix.  If  the  flow  variable  is  an  export 
variable,  its  corresponding  row  of  the  device  structural  Jacobian  matrix  is  extracted.  The 
columns  of  the  device  structural  matrix  row  correspond  tc  the  device  import  variables. 
All  of  the  device  import  variables  can  be  associated  to  either  a  node  potential  (one  of  the 
first  nf  columns  of  the  system  structural  Jacobian)  or  to  one  of  the  remaining  rtf  import 
flow  variable  columns.  Hence  it  is  quite  easy  to  locate  to  which  column  each  element  of 
the  device  structural  Jacobian  row  must  be  added.  If  is  non-zero  for  the  node,  a  D 
code  is  added  to  the  column  corresponding  to  the  node  potential. 
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The  remaining  ny  rows  of  the  system  structural  Jacobian  matrix  are  constructed  by 
examining  each  node  one  at  a  time.  If  the  node  has  an  export  potential  associated  with  it. 
An  /  is  added  to  the  corresponding  node  potential  column  and  potential  equation  row 
element  (unless  of  course  the  node  is  a  reference  node  and  does  not  have  a  column 
associated  with  its  potential).  The  row  of  the  device  structural  Jacobian  matrix 
corresponding  to  the  export  potential  is  then  extracted.  In  exactly  the  same  manner  as 
described  above  for  the  export  flow  variables,  the  columns  of  the  system  structural 
Jacobian  matrix  are  correlated  to  the  columns  of  the  device  structural  Jacobian  matrix. 
Once  correlated,  the  elements  of  the  device  structural  Jacobian  row  are  subtracted  from 
the  appropriate  elements  of  the  system  structural  Jacobian  matrix.  If  R^*  is  non-zero  for 
the  node  and  the  terminal  having  the  export  potential  has  an  import  flow  variable,  then  a 
D  is  added  to  the  column  corresponding  to  the  import  flow  flow  variable.  If  R^*  is 
non-zero  for  the  node  and  the  terminal  having  the  export  potential  has  an  export  flow 
variable,  then  a  D  is  multiplied  by  the  elements  of  the  corresponding  row  of  the  device 
structural  Jacobian  matrix  before  being  added  to  the  corresponding  cojumn  in  the  system 
structural  Jacobian  matrix. 

Once  the  structural  Jacobian  matrix  has  been  constructed  it  can  be  examined  to 
ensure  there  are  no  glaring  problems  such  as  a  row  or  column  containing  only  0  elements. 
If  a  row  or  column  contains  only  0  elements,  the  system  is  ill-posed  and  can  not  be 
solved. 

3.2.5 2  Blocks 

The  primary  reason  for  constructing  the  system  structural  Jacobian  matrix  is  to 
break  down  the  system  of  equations  and  system  variables  into  smaller  blocks  which  can 
be  sequentially  solved  instead  of  solving  the  entire  system  at  once.  A  block  Bt  is  defined 
as  nw  system  variables  and  %  equations  which  only  depend  on  system  variables  of  the 
present  block  and  previous  blocks  in  the  sequence.  A  block  of  size  nw  is  identified  by 
finding  nu  rows  in  the  system  structural  Jacobian  matrix  that  have  not  already  been 
allocated  to  a  block  and  have  exacdy  nu  columns  containing  non-0  elements.  Of  the 
many  combinations  of  blocks  which  can  be  found  for  a  system,  the  best  combination 
contains  the  largest  number  of  small  blocks.  Here  is  an  algorithm  for  finding  the  blocks: 

1 .  Create  a  list  for  each  row  containing  the  number  of  unallocated  non-0  entries 
in  that  row.  (Initially  all  the  rows  and  columns  are  unallocated) 
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2.  Examine  the  list  for  rows  having  only  1  unallocated  non-0  entries.  Create  a 
block  for  each  of  these  rows  and  their  associated  columns.  Mark  the  rows  and 
columns  as  allocated. 

3.  Update  the  list  of  unallocated  non-0  entries  in  each  row. 

4.  Continue  steps  2  and  3  until  no  more  single  rows  can  be  allocated. 

5.  Examine  the  list  for  two  rows  only  having  unallocated  non-0  entries  in  the 
same  two  columns.  Create  a  block  for  each  pair  of  rows  and  their  associated 
columns.  Mark  the  rows  and  columns  as  allocated. 

6.  Update  the  list  of  unallocated  non-0  entries  in  each  row. 

7.  Repeat  steps  2-6  until  no  more  single  row  and  double  row  blocks  can  be 
identified. 

8.  Examine  the  list  for  three  rows  only  having  unallocated  non-0  entries  in  the 
same  three  columns.  Create  a  block  for  each  set  of  three  rows  and  their 
associated  columns.  Mark  the  rows  and  columns  as  allocated. 

9.  Update  the  list  of  unallocated  non-0  entries  in  each  row. 

10.  Repeat  steps  2-9  until  no  more  blocks  of  up  to  size  3  can  be  identified. 

11.  Continue  the  above  algorithm  until  all  of  the  rows  and  columns  have  been 
allocated.  Remember  it  is  necessary  to  go  back  and  attempt  to  identify 
smaller  sized  blocks  after  discovering  a  larger  block  since  the  removal  of  a 
column  could  allow  the  identification  of  a  new  smaller  block. 

The  order  of  identifying  blocks  is  very  important  because  they  must  be  solved  in  the 
same  order.  Each  block  contains  the  same  number  of  system  variables  and  system 
equations.  The  equations  only  depend  on  system  variables  determined  from  the  present 
and  previous  blocks.  Hence  the  simulation  problem  becomes  an  issue  of  solving 
sequences  of  relatively  small  systems  of  equations  described  by  blocks. 

3.2.6  Reduced  System 

The  reduced  system  consists  of  the  sequence  of  blocks  which  when  solved,  provide 
the  solution  for  all  the  system  variables.  Solving  each  of  the  blocks  can  be  done  a  number 
of  ways.  Most  schemes  start  with  an  initial  guess  for  the  system  variables  and  generate 
corrections  to  the  guesses  until  all  of  the  system  equations  for  that  block  are  satisfied. 
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Generating  the  corrections  is  normally  done  through  the  use  of  a  block  Jacobian  matrix 
which  can  be  constructed  in  much  the  same  manner  as  the  system  structural  Jacobian.  If 
the  block  structural  Jacobian  does  not  contain  any  A,  N  or  U  elements,  the  block  Jacobian 
can  be  inverted  and  multiplied  by  the  system  equation  errors  to  provide  the  required 
corrections.  If  there  are  any  nonlinearities,  this  scheme  can  be  performed  several  times 
until  the  system  equation  errors  are  close  to  zero.  This  method  is  commonly  referred  to  as 
the  Newton-Raphson  method  and  if  the  initial  guess  is  close  enough  to  the  solution,  the 
method  converges  quadratically.  This  method  is  described  in  much  more  detail  in  section 
3.4.1. 

Relaxation  techniques  can  also  be  used  to  calculate  the  system  variables.  Relaxation 
techniques  start  with  an  initial  guess  for  all  of  the  system  variables  and  update  each 
variable  one  at  a  time  by  solving  a  single  system  equation  by  assuming  all  of  the  other 
variables  are  constant.  Typically,  one  system  equation  is  assigned  the  task  of  solving  for  a 
particular  system  variable.  With  careful  thought  as  to  the  assignment  of  variables  to 
equations,  it  is  often  possible  for  such  a  system  to  converge  to  a  solution.  Common 
relaxation  techniques  are  the  Gauss-Seidel  and  Gauss-Jacobi  methods. 
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3.3  Waveforms 


Up  to  this  point,  the  development  of  the  simulation  structure  has  been  independent  of 
the  manner  in  which  variables  are  actually  described.  The  simplest  and  most  commonly 
used  method  for  representing  variables  is  through  a  single  real  number  representing  the 
value  of  a  variable  at  a  specific  time.  For  static  simulations  where  the  problem  is  to  obtain 
the  steady  state  solution  for  the  system,  this  method  works  very  well.  Appendix  C  and 
Appendix  D  demonstrate  this  procedure  for  the  classic  load  flow  problems.  For  dynamic 
simulations  however,  some  knowledge  as  to  the  time  history  of  the  variables  is  needed  to 
calculate  derivatives  and  integrals.  A  dynamic  simulation  is  implemented  as  a  series  of 
static  simulations  where  the  dynamics  are  represented  by  functions  of  the  time  increment 
and  state  variables.  The  various  integration  techniques  for  this  type  of  simulation  differ 
only  in  the  interpolation  scheme  used  to  approximate  the  variables  between  successive  static 
simulations.  The  time  increment  between  static  simulations  must  be  carefully  controlled  to 
ensure  the  interpolation  scheme  has  enough  accuracy  for  numerical  stability.  Integration  in 
this  manner  requires  careful  control  of  the  time  increment  to  ensure  the  interpolation 
scheme  is  accurate  enough  to  ensure  numerical  stability  along  with  an  accurate  solution. 

Another  approach  to  representing  variables  is  the  waveform.  This  method  employs  a 
vector  of  coefficients  to  continuously  describe  the  time  domain  value  of  the  variable  over 
some  time  interval  [4  fj.  The  type  of  the  waveform  determines  how  the  coefficients  are 
interpreted  to  generate  the  time  domain  values.  Possible  types  include  Data  Series,  Fourier 
Series,  Legendre  Series,  Polynomial  Series  and  Legendre  Series.  The  principal  advantages 
of  using  waveforms  over  discrete  points  include: 

1.  Interpolation  is  not  generally  required  to  determine  intermediate  points.  The 
value  of  a  variable  can  readably  be  determined  for  any  time. 

2.  The  numerical  stability  of  Integration  and  Differentiation  techniques  do  not 
have  to  depend  on  the  time  step  control  since  integration  and  differentiation 
become  waveform  operators  on  an  equal  level  to  all  other  operators.  Time  step 
control  becomes  only  an  issue  of  numerical  accuracy  and  not  of  numerical 
stability. 

3.  Certain  operations  may  be  easier  to  perform  with  one  waveform  type.  The 
ability  to  efficiently  convert  a  waveform  from  one  type  to  another  type  and 
back  again  allows  one  to  use  the  most  efficient  waveform  type  in  the 
calculations  of  a  given  operator. 
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3.3.1  Waveform  Definition 


A  waveform  approximates  the  instantaneous  value  of  a  variable  over  some  time 
interval.  The  elements  of  information  contained  within  a  waveform  must  as  a  minimum 
include: 

1 .  The  name  of  the  waveform 

2.  The  beginning  and  ending  times  of  the  interval  (t0  r,) 

3.  An  Array  of  Coefficients  representing  the  waveform  (c,) 

4.  The  number  of  coefficients  in  the  Coefficient  Array  ( n ) 

5.  A  waveform  type  indicator. 

The  waveform  type  indicator  identifies  how  the  coefficients  should  be 
interpreted  when  operations  are  performed  on  the  waveform.  Here  is  an  example  of  a  C 
structure  defining  a  Waveform: 


typedef  struct  Waveform 


{ 

char  ‘name; 

double  tO; 
double  tl: 
void  *c; 

long  n; 

long  type; 
long  version; 


/*  character  string  of  the  name 
of  the  variable  */ 

/*  time  of  the  beginning  of  the  interval  */ 
/*  time  of  the  end  of  the  interval  */ 

/*  array  of  coefficients  */ 

/*  number  of  elements  in  the  array  */ 

/*  waveform  type  indicator  */ 

/*  Version  of  this  waveform  */ 


struct  Waveform  *next; 
struct  Waveform  *last; 
struct  Jacobian  *jnum; 

struct  Jacobian  *jden; 

} 

WAVEFORM; 


/*  pointer  for  forward 
linked  lists  */ 

/*  pointer  for  backwards 
linked  lists  */ 

/*  pointer  to  linked  list  of 
jacobians  where  this  waveform 
is  the  numerator  */ 

/*  pointer  to  linked  list  of 
jacobians  where  this  waveform 
is  the  denominator  */ 


The  above  definition  also  includes  the  following  optional  information: 


6.  A  Version  Number  to  record  a  change  in  the  waveform’s  properties. 

7.  An  Address  Pointer  to  the  waveform  representing  the  previous  time  interval. 

8.  An  Address  Pointer  to  the  waveform  representing  the  following  time  interval. 

9.  An  Address  Pointer  to  a  linked  list  of  Jacobian  Structures. 
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The  waveform  address  pointers  allow  one  to  construct  a  linked  list  of  waveforms  to 
describe  the  time  history  of  a  variable  over  a  number  of  time  intervals.  The  JdCObidfl 
structure  as  well  as  the  version  number  will  be  described  in  section  3.3.3. 

Note  the  waveform  coefficients  are  declared  to  be  of  type  void.  This  is  done  to  allow 
for  the  coefficients  to  be  abstract  data  representations  in  themselves.  Normally  the 
waveform  coefficients  would  be  double  precision  floating  point  numbers,  but  it  should  also 
be  possible  to  incorporate  other  types  of  data.  It  may  be  advantageous  for  example,  to 
represent  the  coefficients  with  complex  numbers.  In  this  case,  each  element  in  the 
coefficient  array  would  be  a  structure  holding  double  precision  floating  point  numbers 
corresponding  to  the  real  and  imaginary  parts  (Or  magnitude  and  phase  angle)  of  the 
complex  number. 
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3.3.2  Waveform  Operators 

Waveform  Operators  are  functions  which  act  on  waveform  arguments  to  generate 
new  waveforms,  or  provide  some  information  about  the  waveform  arguments.  The  types 
of  functions  can  be  broken  down  into  several  groups: 

1.  Arithmetic  Operators 

2.  Trigonometric/Exponential  Operators 

3.  Switching  Operators 

4.  Integral/Differential  Operators 

5.  Waveform  Content 

6.  Special  Functions 

3.3.2.1  Arithmetic  Operators 

The  arithmetic  operators  are  the  customary  addition,  subtraction,  multiplication, 
division,  and  assignment  operators  usually  associated  with  floating  point  arithmetic.  The 
assignment  operator  is  a  bit  more  complex  since  it  must  incorporate  waveform  type  and 
number  of  coefficient  conversions. 

3.32.2  Trigonometric/Exponential  Operators 

The  Trigonometric/Exponential  operators  include  most  of  the  transcendental 
functions  used  in  engineering.  Examples  include  sine,  cosine,  tangent,  logarithms, 
exponentials,  as  well  as  the  inverse  functions.  Error  handling  can  become  quite  complex 
since  several  of  these  operators  may  be  undefined  at  one  or  more  points  within  the 
argument  waveform.  These  operators  are  usually  handled  by  converting  the  arguments  to 
a  series  of  data  points,  performing  the  operation  point  by  point,  and  then  converting  back 
to  the  appropriate  waveform  type. 

3.3.2J  Switching  Operators 

Switching  Operators  are  operators  producing  waveforms  which  themselves  or  one 
of  their  derivatives  are  discontinuous.  Examples  include  the  absolute  value  function,  the 
sign  function  and  the  step  function.  The  typical  method  for  calculating  these  functions  is 
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to  determine  the  discontinuity  points  and  use  integration  to  create  a  characteristic  function 
series  solution  (e.g.  Legendre  Series  or  Chebyshev  Series)  for  the  result.  The  series 
solution  is  then  converted  to  the  appropriate  waveform  type. 

3.3 2.4  Integral/Differential  Operators 

One  of  the  key  advantages  of  using  waveforms  in  dynamic  simulations  is  that 
integration  and  differentiation  become  very  simple  operators  where  the  stability  of  a 
numerical  integration  scheme  is  generally  not  an  issue.  For  many  waveform  types,  the 
integration  operator  is  a  linear  matrix  operation  with  bounded  coefficients.  If  the 
argument  waveform  has  bounded  coefficients,  the  returned  waveform  will  also  be 
bounded.  Of  course,  numerical  stability  does  not  assure  numerical  accuracy.  Because  the 
integration  operator  typically  generates  some  truncation  error,  the  returned  waveform  can 
still  contain  considerable  errors. 

3.3 2S  Waveform  Content 

The  significance  of  the  Truncation  Error  of  a  waveform  can  be  estimated  by 
calculating  the  waveform  content  of  its  higher  order  term.  The  waveform  content  of  a 
term  is  defined  as  the  magnitude  of  a  coefficient  divided  by  the  square  root  of  the  sum  of 
the  squares  of  all  the  coefficients.  Normally,  one  expects  the  higher  order  terms  of  an 
orthogonal  series  representation  to  progressively  have  smaller  and  smaller  waveform 
contents.  Hence  if  the  last  few  terms  have  values  below  a  preset  threshold,  the  truncation 
error  can  normally  be  assumed  negligible. 

Accurate  truncation  error  estimation  is  still  a  difficult  and  currently  unsolved 
research  topic.  The  waveform  content  method  is  a  practical  method  but  should  not  be 
taken  as  the  last  word  on  the  subject. 

3.3 .2.6  Special  Operators 

Several  special  operators  unique  to  waveforms  should  also  be  developed.  One  very 
useful  operator  returns  the  time  of  zero  crossing  of  the  waveform.  Another  returns  the 
value  and  time  of  every  local  minimum  and  maximum  of  a  waveform. 

The  smoothing  operator  is  one  method  for  reducing  the  waveform  content  of 
higher  order  coefficients.  A  waveform  is  smoothed  by  returning  the  local  average  of  the 
waveform  over  some  prespecified  time  increment.  Smoothing  eliminates  discontinuities 
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in  a  waveform  and  its  derivatives.  Since  discontinuities  tend  to  amplify  the  waveform 
content  of  the  higher  order  terms,  removing  the  discontinuities  should  reduce  the  higher 
order  term  waveform  content. 
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3.3.3  Jacobians 


A  Jacobian  matiix  contains  the  partial  derivatives  of  the  coefficients  of  one 
waveform  with  respect  to  another  waveform  Here  is  a  sample  C  structure  to  define  a 
Jacobian: 


typedef  struct  Jacobian 
{ 

struct  Waveform  *num; 

struct  Waveform  *den; 

long  version; 
long  num__version; 
long  den_version; 
void  **j; 


char  sj; 


/*  address  of  waveform  in  the 
numerator  of  the  partial 
derivatives  */ 

/*  address  of  waveform  in  the 
denominator  of  the  partial 
derivatives  */ 

/*  Version  number  of  the 
jacobian  matrix  */ 

/*  Version  nbr  of 

numerator  Waveform  */ 

/*  Version  nbr  of 

denominator  Waveform  */ 

/*  array  of  jacobian  elements 

The  first  row  index  is  for 
an  array  of  pointers  whose 
elements  are  arrays  with 
the  colum  index  */ 

/*  Structural  Jacobian  Code  */ 


struct  Jacobian  *next;  /*  address  for  linked  list 

of  Jacobians  */ 

} 

JACOBIAN; 


Jacobians  are  used  in  the  process  of  solving  simultaneous  systems  of  waveform 
equations  through  relaxation  methods  or  through  the  Newton-Raphson  Method.  The 
purpose  of  num_v«rsion  and  den_version  is  to  record  which  versions  of  the  numerator 
and  denominator  waveforms  the  jacobian  was  calculated  for.  The  element  version  is  used 
when  several  jacobians  are  combined  and  it  is  necessary  to  determine  whether  the 
combined  matrix  must  be  recalculated. 


In  general,  all  operations  defined  for  a  waveform  should  also  generate  the  jacobian  of 
the  results  with  respect  to  the  arguments.  Through  the  use  of  the  chain  rule,  the  jacobian 
matrix  of  the  export  variables  of  a  device  with  respect  to  the  device  import  variables  can  be 
determined. 

The  Structural  jacobian  code  indicates  the  dependence  and  structure  of  the 
jacobian  matrix.  Here  is  a  list  of  the  codes: 
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Code 

Type  of  Matrix 

0 

Zero  Matrix  (all  elements  are  always  zero) 

I 

Identity  Matrix  (always  the  identity  matrix) 

D 

Diagonal  Matrix  (always  a  linear  main  diagonal  matrix) 

L 

Linear  Matrix  (The  elements  are  always  constant) 

N 

Nonlinear  Matrix  (The  elements  may  not  be  constants) 

U 

Unknown  (The  dependence  is  unknown  (treat  as  nonlinear)) 

The  structural  jacobian  code  along  with  the  version  numbers  determines  whether  or 
not  a  jacobian  matrix  needs  to  be  recalcuated.  If  the  structural  jacobian  is  of  type  0, 1,  D, 
or  L  then  the  jacobian  need  not  be  reconstructed  if  the  there  is  a  version  mismatch  between 
the  waveform  version  and  the  jacobian  version.  If  the  structural  jacobian  of  type  N  or  U, 
and  there  is  a  mismatch  between  the  version  numbers  of  the  jacobian  and  the  waveforms, 
then  the  jacobian  elements  must  be  recalculated.  After  every  recalculation,  the  version 
numbers  are  updated.  In  this  manner,  only  jacobian  matrices  with  changing  coefficients 
are  ever  recalculated. 

Technically,  the  structural  jacobian  codes  depend  on  the  waveform  type  used.  In  this 
thesis  however,  all  of  the  waveform  types  produce  the  same  structural  jacobian  codes. 

3.3.3.1  Jacobian  Operators 

Several  operators  for  jacobian  objects  will  prove  useful  in  developing  a  simulation 
environment.  These  operators  include: 

1 .  Addition  and  Subtraction 

2.  Identity  and  Zero  Jacobian  generators 

3.  Multiplication  by  a  constant 

4.  Multiplication  of  two  jacobians 

5.  Multiplication  of  a  jacobian  by  a  waveform 

6.  Inverting  a  jacobian 

If  the  waveform  is  described  by  an  array  of  double  precision  floating  point  numbers, 
the  Jacobian  coefficients  can  also  be  defined  to  be  an  array  of  double  precision  floating 
point  numbers.  In  this  case,  the  above  operations  employ  standard  matrix  manipulations. 
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3.3.4  Waveform  Examples 


While  the  possibilities  of  waveform  definitions  is  endless,  this  thesis  will  concentrate 
on  the  following  waveform  types: 


Waveform  Type 

Code 

Undefined 

0 

Data  Series 

1 

Fourier  Series 

2 

Legendre  Series 

3 

Polynomials 

4 

Matlab  Polynomials 

5 

Chebyshev  Series 

6 

The  code  in  the  above  table  refers  to  the  value  of  element  type  in  the  WAVEFORM 
structure.  Appendix  E  describes  these  waveforms  and  their  arithmetic  in  great  detail. 
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3.4  Conducting  the  Simulation 

Once  the  physical  system  has  been  specified  by  device  descriptions  and  network 
equations,  the  solution  for  all  of  the  system  variables  can  be  determined  in  several  ways. 
The  method  used  in  this  thesis  is  the  Newton-Raphson  method  with  continuation 
parameters. 

3.4.1  Basic  Newton-Raphson  Algorithm 

The  Newton-Raphson  method  solves  a  system  of  nonlinear  equations  F(x,u )  =  0, 
F()  €  9T,  for  the  system  variables  x  e  9T  with  system  input  variables  u  €  9f”by  first 
linearizing  the  system  of  equations  about  a  given  guess  for  the  solution  x*  then  solving  the 
linear  system  to  produce  a  new  guess  x*+/.  This  procedure  is  repeated  until  Fl  u)  =  0  is 
satisfied  within  a  given  tolerance.  The  sequence  of  points  x*  starting  with  k  =  0  is  called 
the  solution  trajectory  for  x°.  A  converging  solution  trajectory  eventually  converges  to  a 
solution  while  a  diverging  solution  trajectory  does  not. 

F(x,u )  is  linearized  by  taking  the  Taylor  series  expansion  about  the  point  x*: 

F(x,u)  =  F(xk,u)+J(xk,u)xA  +  0(x  x)  =  0 
x  =  x*+xA 


where  the  Jacobian  matrix  7(x*,u)  is  defined  by: 


J(x°,u ) 


dF{x°,u) 

8x 


Assuming  the  error  0(x»x)  is  negligible  and  the  Jacobian  can  be  inverted,  the 
correction  xA  for  a  given  guess  x*  is  given  by  the  linear  approximation: 

xA  =  -J~\xk,u)xk 

The  correction  is  applied  to  x*  to  produce  x*+I,  the  value  of  x  for  the  next  iteration: 

*  +  1  *  , 

X  —X  +xA 

Around  each  solution  of  F(x,u)  =  0  for  which  the  Newton-Raphson  method  reliably 
converges,  a  region  exists  such  that  if  a  trajectory  enters  that  region,  it  will  never  leave  and 
eventually  converge  to  the  solution.  The  size  of  this  local  convergence  region  depends  on 
the  nonlinearity  of  the  system.  For  purely  linear  systems,  this  region  encompasses  the 
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entire  cr"  space.  If  the  intitial  guess  falls  within  the  local  convergence  region,  the 
Newton-Raphson  method  will  by  definition  converge.  If  the  initial  guess  falls  outside  the 
local  convergence  region,  one  of  several  things  can  happen.  First,  the  solution  trajectory 
could  enter  the  local  convergence  region  of  a  solution  and  converge  on  a  solution.  Second, 
the  Newton-Raphson  method  could  fail  due  to  a  singular  Jacobian.  Third,  the  trajectory 
could  diverge  and  tend  to  infinity.  Fourth,  the  trajectory  could  become  cyclic  where 
x**1  =  x*  for  k  sufficiently  large  enough.  Finally,  the  trajectory  could  enter  a  chaotic  region 
in  which  there  is  no  solution  but  from  which  the  trajectory  never  leaves  and  is  not  cyclic. 

As  an  example,  define  F(x,u)  to  be  the  following  lxl  system: 

F(x,u)  =  xi -x 
Figure  3.4.1-1:  F(x,u)  =  x*-x 


The  Jacobian  matrix  is: 

/  =  [3*2-l] 

The  recursion  formula  for  x*+/  is  given  by: 

*♦.  *  c**)3-** 

x  =  x - - — 

3(x*)2  - 1 
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There  are  three  solutions  for  this  system  and  their  local  convergence  regions  are 
given  by: 


Root 

Local  Convergence  Region 

*1  =  -1 

— VF 

x2=  0 

-V 

*3  =  +1 

“S 

1 F*°<~ 

In  two  other  regions,  the  solution  trajectory  jumps  to  one  of  the  local  convergence 
regions  after  one  iteration: 


Root 

Convergence  Region 

|  *i  =  -1 

0.46560  <x°<^ 

0.57735 

S 

+ 

-i 

-0.57735  <  *°  <  -0.46560 

In  two  other  regions,  the  solution  trajectory  may  jump  to  one  of  the  local 
convergence  regions  after  several  iterations  or  fail  to  converge: 


On  the  boundaries  for  the  above  regions,  the  Newton-Raphson  method  fails: 
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Failure  Mode 


Singular  Jacobian 

+0.46560 

Singular  Jacobian 

WT 

Cyclic  Trajectory 

In  the  above  analysis,  no  constraints  were  made  in  the  speed  of  convergence  or  on 
the  size  of  x.  If  |  xk  |»  1  the  speed  of  convergence  will  be  very  slow  since  xt+1 «  ~xl  and 
the  number  of  iterations  l  required  will  be  about: 


l-k 


log(U*  I) 
log(1.5) 


~  5.68  log(|  xk  |) 


Furthermore,  most  machines  have  a  limit  as  to  the  largest  number  which  can  be 
represented.  If  an  iteration  causes  x  to  exceed  this  number  in  magnitude,  a  floating  point 
overflow  error  will  typically  be  generated.  This  phenomena  is  known  as  Newton  Overflow 
and  has  the  effect  of  reducing  the  size  of  the  convergence  regions.  For  example,  if  x  is 
known  to  be  bounded  by  the  interval  [-10  10],  then  x®  should  be  restricted  to  the  following 
regions: 


Root 

Convergence  Region  | 

*i  =  -1 

-10  <x°< -0.58904  I 

0.46560  <x°<  0.56675  1 

*2-0 

-0.44721  <x°<  =  0.44721  j 

+ 

II 

H 

-0.56675  <x°< -0.46560 

0.58904  <x°<  10.0 
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3.4.2  Continuation  Methods  with  Newton-Raphson 

The  previous  discussion  indicates  the  need  for  careful  selection  of  the  initial  guess  x°. 
The  use  of  a  continuation  parameter  in  so  called  homotopy  methods  is  one  of  the  many 
ways  for  attempting  to  generate  x°  within  the  convergence  region  of  the  desired  solution. 
In  general,  a  function  H(x,u, a)  =  0  is  generated  such  that  H(x,u,  1)  =  F(x,u )  and 
H(x,u,Q )  =  G(x,u )  where  G(x,u)  is  a  linear  function  in  x.  One  common  method  of  creating 
H(x,u,a )  is: 

H(x,u, a)  =  aF(x,u)  +  (l  -a)G(x,u) 

The  problem  now  is  to  develop  the  linear  function  G(x,u).  There  are  several 
approaches  which  can  be  taken  for  each  row  G,(x,u): 

1.  Linearize  about  a  known  operating  point.  This  is  equivelent  to  providing  an 
initial  guess  for  each  of  the  variables  and  using  the  Newton-Raphson  method 
directly. 

2.  Use  a  least  squares  fit  of  a  linear  system  over  a  known  operating  region  of 
F{x,u). 

3.  Select  G^x,u)  such  that  the  solution  for  H(x,u,0)  =  0  is  most  likely  to  be  within 
the  convergence  region  of  F(x,u). 

Once  H(x,u,a)  has  been  constructed,  it  can  be  used  in  several  ways: 

1.  Start  with  <x=0  and  obtain  a  solution  to  the  linear  system,  then  progressively 
increment  alpha  by  small  amounts  and  solve  the  nonlinear  system  until  a=l.  The 
rational  is  to  employ  the  unbounded  local  region  of  convergence  of  the  linear  system 
to  move  the  initial  guess  into  the  local  region  of  convergence  for  the  next  nonlinear 
system  formed  by  incrementing  a.  As  a  is  incremented,  the  solution  for  the  previous 
value  of  a  is  assumed  to  be  within  the  local  region  of  convergence  for  the  present 
value  of  alpha.  Appendix  B  demonstrates  this  may  not  always  happen  due  to 
bifurcations  of  solutions  as  a  is  incremented. 

2.  Start  with  a=l  and  attempt  to  obtain  a  solution  to  the  nonlinear  solution.  If  the 
trajectory  has  not  converged  after  n iterations,  decrement  a  and  attempt  to  find  a 
solution.  Progressively  decrement  a  until  a  solution  is  obtained,  then  increment  a 
using  the  solution  of  the  previous  value  for  a  for  the  initial  guess.  This  procedure 
assumes  the  local  convergence  region  for  a  given  solution  will  increase  as  a  is 
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decremented.  Eventually  the  local  convergence  region  should  grow  large  enough  to 
encompass  even  a  poor  guess  for  the  solution.  This  procedure  has  the  advantage  over 
the  previous  method  in  that  it  may  avoid  bifurcations  which  occur  between  0  and  the 
minimum  value  for  a  used.  However,  the  number  of  iterations  for  a  may  be  larger. 

Note  that  the  value  for  nw  as  well  as  the  convergence  criteria  may  be  a  function  of 
a.  There  is  no  reason  to  obtain  a  highly  accurate  solution  for  intermediate  values  of  a 
since  the  only  purpose  is  to  move  the  initial  guess  for  the  next  a  iteration  into  the  new 
local  region  of  convergence.  Only  when  a=l  should  the  convergence  criteria  be  enforced 
for  obtaining  a  highly  accurate  solution. 
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3.4.3  Simulation  Algorithm 

The  simulation  algorithm  employed  by  WAVESEM  is  conducted  totally  within  the 
MATLAB  environment  and  is  composed  of  four  parts.  The  first  part  initializes  all  of  the 
simulation  parameters.  The  second  part  performs  the  time  increment  control  and  has 
embedded  with  in  it  the  third  part  which  is  the  sequential  solving  of  each  of  the  blocks. 
The  final  part  is  composed  mostly  of  plotting  and  storing  the  results  of  the  simulation. 

Figure  3.43-1:  Simulation  Flowchart 
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3.4.3.1  System  Initialization 


A  number  of  parameters  and  arrays  need  initialization  before  the  simulation  can 
commence.  These  parameters  and  arrays  are: 


n  Initial  number  of  waveform  coefficients 

n  Actual  number  of  waveform  coefficients  used 


wtypa 


Waveform  type  indicator 


to 

ti 


Beginning  time  of  simulation 
Ending  time  of  simulation 


sb_n_min  Minimum  number  of  coefficients  to  use 

sb  n  max  Maximum  number  of  coefficients  to  use 


sb_n_data 

sb_dt_init 
sb  dt_opt imum 

sb_dt_min 
sb  dt  max 


Number  of  points  per  waveform  for  plots 

Initial  time  increment 
Optimum  time  increment 

Minimum  time  increment 
Maximum  time  increment 


sb  dt  ave 


Minimum  time  of  interest  (Averaging  interval) 


Break  Points  are  user  specified  times  for  which  waveform  interval  boundaries  are 
forced  to  occur.  Break  Points  are  completely  optional  and  their  inclusion  is  up  to  the 
system  modeler. 


sb_bp 

sb_bp_nbr 

sys_node_serial 
sys  node  name 

sb_alpha_init 

sb_dalpha_init 

sb_dalpha_min 

sb_dalpha_max 

sys_Qmin 

sys_Rmin 


Array  of  Break  Points 
Number  of  break  points 

Array  of  Node  Serial  Numbers 
Array  of  Node  Names 

Initial  Value  of  continuation  parameter  alpha  for  nonlinear 
blocks 

Initial  Value  of  alpha  increment 

Minimum  alpha  increment 
Maximum  alpha  increment 

Array  of  Gmin  values  for  all  of  the  nodes 
Array  of  Rmin  values  for  all  of  the  nodes 


The  index  for  sys_Gmin  and  sys_Rmin  are  the  node  numbers  of  the  nodes  they 
apply  to. 
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sb_check_eqn_err  =  0  for  don’t  check  equation  error 

=  1  for  checking  equation  error 

sb_check_yar_err  =  0  for  don’t  check  max  variable  correction 

=  1  for  checking  max  variable  correction 

sys_kcl_err  Array  of  maximum  KCL  errors  for  all  nodes 

aya_pot_err  Array  of  maximum  Potential  Differences  for  all  nodes 

aya_nd_err  Array  of  max  corrections  to  Node  Potentials  for  all  nodes 

aya_fv_err  Array  of  max  corrections  to  Flow  Variables  for  all  nodes 

sb_i_Jccl_err  Multiplier  for  maximum  KCL  error 

for  alpha  less  than  1 

ab_i_pot_err  Multiplier  for  maximum  Potential  Difference 

for  alpha  less  than  1 

ab_i_nd_err  Multiplier  for  max  correction  to  node  potential 

for  alpha  less  than  1 

sb_i_fv_err  Multiplier  for  max  correction  to  flow  variable 

for  alpha  less  than  1 

The  index  for  the  above  eight  arrays  are  the  node  numbers  of  the  nodes  they  apply 
to. 

sb_maxcnt  Maximum  number  of  iterations  for  alpha  =  1 

sb_i_maxcnt  Maximum  number  of  iterations  for  alpha  <  1 

sb_div_st*rt_cnt  Number  of  iterations  to  skip  before  checking 

for  divergence 

sb_diyjmax_cnt  Maximum  number  of  diverging  iterations  before 

assume  system  is  diverging 

sb_i_div_err  Multiplier  of  errors  for  ignoring  diverging  check 

sb_m*x_wc  Maximum  waveform  content  of  a  waveform 

sb_nbr_wc  Number  of  coefficients  to  apply  waveform  content  to 

sb_mult_wc  Multiplier  to  sb_max_wc  for  decrementing  n 

sys_pot_scaia  Array  of  Scaling  factors  for  node  potentials 

sys_flow_scal«  Array  of  Scaling  factors  for  flows  attached  to  nodes 

The  index  for  sya_pot_scaie  and  sys_fiow_scaie  are  the  node  numbers  of  the 
nodes  they  apply  to. 

dev jpa r_naune  Device  parameter  arrays:  name  is  the  device  name 

dev_sO_name  Device  state  initial  value  array: 

name  is  the  device  name 
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ivar_nd_nbr 
ivart_nd_/ibr 
ivar_fv_najne 
i.vart_f  v_name 

hia_t 

his_N 
his_col 
hi  s_nd_nbr 

his_£v_nama 

his  s  name 


blJt_ixbr_nrow 

blk_nbr_ncol 

blk_nbr_row_ays 

blk_xibr_col_sys 


Initial  guesses  for  node  potentials: 

nbr  is  the  node  serial  number 
Waveform  type  for  initial  guess 

nbr  is  the  node  serial  number 
Initial  guess  for  flow  variables: 

name  is  the  variable  name 
Waveform  type  for  initial  guess 
name  is  the  variable  name 

Matrix  of  time  increment  end  points 
First  row  is  beginning  of  intervals 
Second  row  is  end  of  intervals 
Columns  are  waveform  interval  index 

Vector  of  number  of  coefficients  in  waveforms  for  each 
waveform  interval 

The  waveform  interval  index.  After  simulation  this  equals 
the  number  of  columns  in  history  arrays 

Matrix  of  Node  Potential  waveforms.  Each  column 
corresponds  to  the  waveform  for  the  node  potential  over  a 
given  waveform  interval,  nbr  is  the  node  serial  number 

Matrix  of  Import  Flow  Variable  waveforms.  Each  column 
corresponds  to  the  waveform  for  the  import  flow  variable 
over  a  given  waveform  interval,  name  is  the  variable  name 

Matrix  of  Device  name  state  values.  The  first  column 
corresponds  to  the  initial  state  values  with  subsequent 
columns  corresponding  to  the  state  values  at  the  end  of 
waveform  intervals.  Note  this  matrix  has  1  more  column 
than  all  the  other  history  arrays. 

Number  of  rows  in  block  nbr 

Number  of  columns  in  block  nbr 

Cross  Reference  of  Block  nbr  rows  to  System  Rows 

Cross  Reference  of  Block  nbr  columns  to  System  Columns 


blk_nbr_linear_£lag  =  0  if  block  nbr  is  nonlinear 

=  1  if  block  nbr  is  linear 
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Time  Increment  Initialization 

ddt  Actual  time  increment 

tto  Beginning  of  current  waveform  interval 

tti  End  of  current  waveform  interval 

ddt,  ttO,  and  ttl  are  initialized  according  to  the  following  equations: 

ddt  -  ab_dt_init 
ttO  =  to 

ttl  =  minimum  of: 
to  +  ddt 
tl 

sb_bp (1) 

cnt  tot  Set  to  zero:  Total  number  of  Jacobian  inverses 

his_£iops  Number  of  floating  point  operations  used 
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3.4.3.2  Time  Loop 


Truncation  Error  Control 

The  simulation  time  interval  between  to  and  ti  may  be  divided  into  a  number  of 
waveform  intervals  to  improve  the  truncation  error  of  the  system  variable  waveforms.  In 
general,  truncation  error  can  be  reduced  by  either  increasing  n  or  by  decreasing  the 
waveform  interval  ttl  -  ttO.  Within  WAVE  SIM,  the  general  strategy  for  dealing  with 
too  large  of  a  truncation  error  is  to  increase  the  number  of  coefficients  n  if  the  waveform 
interval  is  less  than  sb_dt_optimum  and  shorten  the  waveform  time  interval  if  greater 

than  3 b_dt _ opt imum  In  general,  the  strategy  is  to  minimimize  n  while  maximizing  the 

waveform  interval  subject  to  the  constraint  that  the  truncation  error  is  within  tolerances. 
Finding  the  optimum  combination  of  waveform  intervals  and  number  of  coefficients  is 
not  obvious  and  much  work  remains  for  developing  better  algorithms. 

3.4.3.2.1  Time  Loop  iteration  initialization 

The  simulation  time  loop  continues  as  long  as  ttO  <  tl.  The  beginning  of  each 
iteration  begins  with  the  definition  of  the  following  arrays: 

tt  =  [ttO  ttl  sb_dt_ave ] 

ii  =  Identity  Matrix  of  size  N 
it  -  Zero  Matrix  of  size  nxn 

Variable  Initial  Guesses 

Next,  initial  guesses  are  provided  for  all  system  variables  (var_nd_nbr  and 
var  fv  name)  by  converting  the  waveforms  ivar_nd_nbx-  of  type  ivart_nd_abr  and 
waveforms  ivar_fy_naine  of  type  ivart  fv_name  into  waveforms  of  type  Ktype  and 
size  n. 

In  the  present  incarnation  of  WAVESIM,  the  same  waveform  is  used  as  the  initial 
guess  for  all  waveform  time  intervals  regardless  of  the  values  for  ttO  and  ttl. 
Normally,  a  constant  value  is  specified.  A  better  method  would  allow  the  user  to  specify 
an  actual  guess  as  to  the  waveform  history  as  a  function  of  time.  The  time  loop  iteration 
initialization  would  then  have  the  responsibility  of  converting  the  waveform  data  as 
provided  by  the  user  into  a  waveform  of  type  wtype  and  size  n  over  the  interval  between 
ttO  and  ttl.  Providing  an  initial  guess  for  the  wavefo.m  history  of  all  the  variables 
would  allow  for  example,  a  linear  model  of  a  system  be  run  first  to  generate  the  initial 
guess  for  a  nonlinear  model  of  the  same  system.  Convergence  of  the  nonlinear  system 
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should  be  greatly  accelerated  for  many  systems.  Parameter  sensitivity  studies  would 
also  be  greatly  accelerated  if  the  parameter  variations  are  not  expected  to  cause  major 
changes  in  system  performance. 

Failure  Flags 

Two  final  variables,  converge_faiiure  and  £atai_error  are  initialized  to  zero. 
converge_faiiure  is  set  to  one  by  a  block  if  convergence  failed  for  that  block  or  if  one 
of  the  block  waveforms  has  too  large  of  a  harmonic  content.  Convergence  could  fail  if 
the  number  of  iterations  exceeded  the  maximum  allowed  and  the  alpha  increment  is 
smaller  than  the  minimum  allowed.  converge_£ailure  is  used  to  indicate  the  following 
blocks  should  not  be  solved  because  previous  blocks  could  not  be  solved.  £atai_error 
is  set  to  one  if  convergence  cannot  be  obtained  even  when  n  is  equal  to  or  greater  than 
the  maximum  value  sb_n_max  and  the  time  increment  is  equal  to  or  smaller  than  the 
minimum  value  sb  dt  min.  If  £atal_error  is  set,  the  simulation  fails. 
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3A.32.2  Solving  the  Blocks 


The  blocks  are  solved  sequentially  in  the  order  of  their  detection  in  the  system 
reduction  procedure.  If  converge_faiiure  is  nonzero,  a  previous  block  could  not  be 
solved  for  the  given  time  increment  and  number  of  coefficients.  For  this  reason,  a  block 
is  not  solved  if  converge_f allure  is  nonzero. 

Figure  3.4.3-2:  Solving  the  Block 


3.4.3.2.2.1  Block  Initialization 

Each  block  requires  the  initialization  of  several  arrays  and  variables  before  the 
block  can  be  solved: 
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biJc_nbr_max_eqnerr  Array  of  maximum  errors  for  the  block  equations 

bik_nbr_ma*_varcor  Array  of  maximum  variable  corrections  for  the  block 

variables 

blk_nbr_imajc_eqnerr  Array  of  multipliers  to  blk_nbr_max_eqnerr  for 

alpha  <  1 

blk_nbr_lmax_varcor  Array  of  multipliers  to  blk__nbr_max_varcor  for 

alpha  <  1 

bik_nbr_cnt  Number  of  iterations  (initialized  to  0) 

bik_abr_cnt_div  Number  of  diverging  iterations  (initialized  to  0) 

bik_nbx_aipha  Block  continuation  parameter. 

=  1  if  linear  block 

=  sb_aipha_init  if  nonlinear  block 

bik_nbr_daipha  Block  continuation  parameter  increment 

=  sb_dalpha_init 

good_aipha  Last  value  of  alpha  for  which  block  converged. 

Initialized  to  -1 

good_var_nd_nbx  Last  value  of  node  nbr  potential  for  which  block 

converged.  Initialized  to  var_nd_nbr 

good_var_fv_name  Last  value  of  import  flow  name  for  which  block 

converged.  Initialized  to  var_fv_name 

blk_nbr_trec  Recommended  recalculation  time  for  block 

Initialized  to  tti 

blk_nfor_ivc  Array  of  indexes  in  block  variable  array  for  which  the 

variable  correction  was  greater  than  allowed. 
Initialized  to  an  empty  array. 

div_cnt  Number  of  diverging  iterations,  set  to  0 

div_err  Maximum  relative  error  of  previous  iteration 

Initially  set  to  0. 
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3.4.3.2.2.2  Continuation  Parameter  Loop 


The  block  continuation  parameter  loop  continues  as  long  as  bik_nbr_*lph*  <  1. 
Within  this  loop,  the  following  procedures  occur: 

1.  Import  Variables  for  all  associated  devices  specified 

2.  Device  Objects  called  to  generate 

A.  Export  Variables 

B.  Device  Jacobian  Matrix 

C.  State  values  at  time  tti 

D.  Recommended  recalculation  time 

3.  Block  recalculation  time  calculated 

4.  KCL  and  Potential  Difference  Equation  Errors  calculated 

5.  Errors  Scaled  and  compared  to  maximum  limits 

if  good,  solution  saved  and  bik_nbr_alpha  incremented 
as  necessary. 

6.  Iterations  counted  and  compared  to  maximum  limit 

bik_nbx_aipha  decremented  and  variables  reset 
as  necessary. 

7.  Block  Jacobian  Matrix  assembled  and  scaled 

8.  Variable  Corrections  Calculated 

9.  System  variables  corrected 

3.4.3.2.2.2.1  Device  Import  Variable  specification 

The  matrix  dev_i_name  is  generated  for  each  device  name  where  the  columns 
are  the  waveform  coefficients  for  each  of  the  device  import  variables.  Each  column  of 
the  dev_i_name  matrix  is  one  of  the  system  variables,  hence  all  are  available. 

3.43.2.2.2.2  Call  Device  Objects 

Each  of  the  device  objects  associated  with  the  block  is  provided  with  the 
following  information: 

wtypa  Waveform  type 

dev_i_name  Device  name  import  variable  matrix 
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dev_par_name  Device  name  parameter  array 

de v_s 0_name  Device  name  state  initial  value  tto  array 

tt  Time  structure 

bik_nZ>x_aipha  Block  nbr  Continuation  Parameter 

From  this  information,  each  of  the  device  objects  generates  the  following 

dev_e_name  Device  name  export  variable  matrix 

dev_ j_name  Device  name  jacobian  matrix 

dev_si_name  Device  name  state  final  value  tti  array 

de v_t x_a ante  Device  name  recommended  recalculation  structure 

=  [ntl  ntt]  where 

nti  =  recommended  tti  for  present  interval 
or  set  to  tti  if  no  recommendation 
ntt  =  recommended  tti  for  next  interval 

or  set  to  tto  if  no  recommendation 

3.4.3.2.2.23  Recommended  Recalculation  Time 

The  block  recommended  recalculation  time  bik_nbr_trec  is  set  to  the 
minimum  value  of  all  the  ntl  values  from  all  of  the  devices  associated  with  the  block. 
If  convergence  fails  blk_nbr_trec  is  used  to  generate  a  new  value  for  tti. 

Similarly,  bik_nbi-_ntrec  is  set  to  the  minimum  value  of  all  the  ntt  values 
greater  than  tti  from  all  of  the  devices  associated  with  the  block.  For  a  successful 
convergence,  bik_nbr_ntrec  is  used  to  help  generate  a  new  value  for  tti  for  the 
next  waveform  interval. 

3.43.2.2.2.4  Equation  Errors 

For  each  of  the  node  nd  KCL  equations  associated  with  block  nbr,  an  error 
variable  bik_nbr_kd_nd  is  generated  by  adding  the  flow  variables  of  the  attached 
terminals  to  the  flow  through  Gmin.  Likewise,  for  each  of  the  export  potential  name 
Potential  Difference  equations  associated  with  block  nbr,  an  error  variable 
bik_nbr_pot_name  is  generated  by  subtracting  from  the  node  potential  waveform,  the 
waveform  of  the  export  potential  as  well  as  the  contribution  from  Rmin 

blk_nbr_kcl_nd  =  Z  dev_e_name  ( : ,  col)  +  I  var_fv  vnama  + 

var  nd  nJ  x  Gmin 
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where 


blk_nb.r_pot_vnanie  =  var_nd_nd  -  dev_e_name  ( : ,  col) 
dev  x  name (:,  col)  x  Rmin 


obr 

Block  Number 

ad 

Node  Serial  Number 

name 

Device  name 

vname 

Variable  name 

( : ,  col) 

The  appropriate  column  from  the  matrix 

X 

Either  e  or  i  depending  on  associated  flow  variable 
being  an  export  or  import  variable 

The  KCL  equation  errors  are  multiplied  by  the  appropriate  flow  variable  scaling  factor 
from  the  sys_fiow_scaie  array  while  the  Potential  Difference  equation  errors  are 
multiplied  by  the  appropriate  potential  scaling  factor  from  the  sys_pot_scaie  array. 
Once  scaled,  the  error  vectors  are  assembled  into  a  block  error  vector  bik_nbr_err. 

3.4.3. 22.2.5  Error  Criteria  Check 

Applying  Error  Criteria 

If  blk_nbr_aipha  >  l  then  blk_nbr_ier  is  filled  with  the  indexes  of  the  rows 
of  blk_abx_err  which  are  greater  in  magnitude  than  the  corresponding  rows  of 
blk_nbr_max_eqnerr.  In  the  same  manner,  blk_nbr_rel_err  is  set  equal  to  the 
absolute  value  of  b  1  k_n£>x-_e r r  divided  by  blk_nbr_max_eqnerr. 

If  blk_nbr_alpha  <  l  then  blk_nbr_ier  is  filled  with  the  indexes  of  the  rows 
of  hlk_nbz-_err  which  are  greater  in  magnitude  than  the  corresponding  rows  of 
blk_nbr__imax_eqnerr.  Similarly,  blk_nb.r_rel_err  is  set  equal  to  the  absolute 
value  of  blk_nbr_err  divided  by  b  1  k_abr_imax_e qne r r . 

Divergence  Check 

On  the  first  iteration  for  a  given  value  bik_nbr_alpha,  div_cnt  is  initialized  to 
0.  For  the  first  sb_div_start_cnt  -  l  iterations,  div_err  is  set  to  the  maximum 
value  of  blk_nbr_rel_err.  On  subsequent  iterations,  if  the  maximum  value  of 
bik_nbr_rei_err  is  smaller  than  div_err  then  div_cnt  is  reset  to  0,  otherwise 
div_cnt  is  incremented.  In  any  case  div_err  is  set  to  the  maximum  value  of 
blk_nbr_rel_err.  If  div_cnt  >  sb_div_max_cnt  then  the  algorithm  assumes  the 
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block  is  diverging  for  the  given  value  of  blk_nbr_alpha.  The  failure  to  converge 
condition  is  indicated  by  setting  blk_nbr_cnt  =  maxcnt:  either  sb_i_maxcnt  if 
blk_nb,r_alpha  <  1  or  sb  maxcnt  if  blk_nbr_alpha  >  1. 

Block  Convergence  Success 

If  blk_nbr_ier  is  the  empty  set  or  sb_check_eqn_err  is  0,  and 

bik_nbr_aipha  >  i  and  bik_nbr_ivc  is  the  empty  set,  then  the  block  solving 
algorithm  has  been  completed  and  the  continuation  parameter  loop  is  broken.  The 
algorithm  proceeds  to  checking  the  truncation  error  for  the  system  variables  associated 
with  the  block. 

Increment  Continuation  Parameter 

If  blk_nbr_ier  is  the  empty  set  or  sb_check_eqn_err  is  0,  and 

b X k_n£>r_a l pha  <  i  and  blk_nbr_ivc  is  the  empty  set,  then  it  is  time  to  increment 
the  continuation  parameter  blk_nbx_alpha.  First  however,  the  current  value  of  all 
the  variables  associated  with  the  block  are  copied  into  good_var_nd _nd  or 
good_var_f v_n*ma.  blk_ni>r_alpha  is  copied  into  good_alpha.  The  variables  and 
continuation  parameter  must  be  saved  because  it  may  be  necessary  to  restore  the 
variables  if  the  block  fails  to  converge  with  the  next  continuation  parameter  value. 
bik_nbr_aiph*  is  then  set  equal  to  the  minimum  of  1  and 
blk_abr-_aipha  +  blk_nbr_d*lpha  and  the  continuation  parameter  loop  is  repeated. 

Iteration  Count:  Decrement  Continuation  Parameter 

If  the  error  is  still  too  large,  corrections  to  the  system  variables  associated  with 
the  block  must  be  generated.  But  first,  the  number  of  iterations  blk_nbr_cnt  must  be 
incremented  and  compared  to  the  maximum  allowed  maxcnt:  either  sb_i_maxcnt  if 
blk_nbr_alpha  <  1  or  sbjmaxcnt  if  blk_nbr_alpha  >  1.  If  the  limit  has  been 
exceeded,  and  one  of  the  devices  has  recommended  a  value  for  blk_nbr_trec  less 
than  ttl,  then  converga_failure  is  set  to  1  and  attempts  to  solve  the  block  cease.  If 
the  limit  has  been  exceeded  and  blk_nbr_trec  equals  ttl,  the  block  is  recalculated 
with  a  decremented  blk_nbr_alpha  which  is  set  to  the  maximum  of: 

(blk_nbr_alpha  +  good_alpha)  /  2 
blk_nbr_alpha  -  blk_nbr_dalpha 
0 
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If  bik_nbr_alpha  has  been  decremented,  the  system  variables  associated  with 
the  block  must  be  reset  to  the  values  stored  in  either  good_var_nd_nd  or 
good_var_fv_naine. 

Block  Convergence  Failure 

If  blk_nbr_alpha  -  good_alpha  <  sb_dalpha_min  then  the  block  has  failed 
to  converge  and  nothing  more  can  be  done  on  the  block  level.  The  variable  tree  is 
Set  equal  to  blk_n£>r_trec  and  the  converge_£ai.lure  flag  is  set  to  1.  This  is  a 
signal  to  the  system  to  not  solve  any  more  blocks  and  either  adjust  the  value  of  tti  or 
adjust  the  number  of  coefficients  n  before  trying  to  solve  the  system  again. 

3A.3.2.2.2.6  Assemble  Jacobian 

Jacobian  Construction 

If  the  error  is  too  large,  but  the  maximum  number  of  iterations  maxent  has  not 
been  exceeded,  the  block  jacobian  matrix  must  be  calculated.  The  block  jacobian 
matrix  bik_nbr_j  is  constructed  in  the  same  manner  as  the  system  structural  jacobian 
was  previously  constructed  "'ith  the  exception  that  now  the  variables  and  equations 
are  only  those  which  are  p,  rt  of  the  block  and  the  matrix  elements  are  submatrices 
instead  of  structural  jacobian  codes. 

Jacobian  Scaling 

Once  the  block  jacobian  has  been  assembled,  it  is  scaled  by  dividing  each  of  the 
columns  by  the  appropriate  element  of  either  the  sya_£low_scale  (if  the  column 
corresponds  to  an  import  flow  variable)  or  sys_pot_scaie  (if  the  column  corresponds 
to  a  node  potential)  vectors.  Likewise,  rows  of  the  block  jacobian  are  multiplied  by 
the  appropriate  element  of  either  the  sys_£iow_scaie  (if  the  row  corresponds  to  a 
KCL  equation)  or  sys_jp©t_scaie  (if  the  row  corresponds  to  a  Potential  Difference 
equation)  vectors.  Scaling  is  performed  to  normalize  all  of  the  variables  and 
hopefully  improve  the  accuracy  of  the  numerical  computations  required  for  solving 
the  variable  corrections. 

Correction  Vector  Calculation 

The  variable  correction  vector  blk_nbr_dlta  is  generated  by  solving  the  matrix 
equation: 
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blk_ni>r_j  blk_nbr_dlta  =  b  1  k_nbr_e r r 

The  most  direct  method  (and  one  of  the  least  numerically  efficient  method)  of 
calculating  blk_nbr_dlta  is  to  invert  blk_nbr_j  and  multiply  by  blk_abr_err. 
Relaxation  methods  and  Gaussian  elimination  with  back  substitution  are  other  means 
to  the  same  end. 

Singular  Jacobian 

If  blk_nbr__ j  is  singular,  blk_nbr_dlta  can  not  be  calculated  and  in  the  present 
incarnation  of  WAVESIM,  the  simulation  fails.  Future  versions  should  include  an 
algorithm  for  attempting  to  recover  from  the  singular  jacobian. 

3.4  J.2.2.2.7  Correct  Variables 

Each  of  the  system  variables  associated  with  the  block  are  corrected  by 
subtracting  the  appropriate  rows  of  bik_nbx_dita  divided  by  the  corresponding 
element  of  the  scaling  factor  vectors  (sys_pot_scaie  or  ays_fiow_scaie). 

3.4.3.2.2.2.8  Variable  Correction  Criteria 

If  the  block  is  nonlinear  (blk_nbr_linear_flag  =  o)  and  the  variable 
correction  flag  is  set  (sb_check_var_err  =  l)  then  blk_nbr_ivc  contains  the 
indexes  of  blk_nbr-_dlta  which  exceed  in  magnitude  blk_n/>r_ima:x:_v-arcor  if 
blk_abx-_alpha  <1  or  blk_nbr_xnaac_varcor  if  blk_nbr_alpha  >1.  If 
bik_nbr_ivc  is  not  empty,  then  one  of  the  variable  corrections  was  too  large  and 
another  iteration  is  necessary.  In  any  case,  the  continuation  parameter  loop  is 
repeated. 
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3.4.3.2.23  Truncation  Error  Control 

Once  a  block  has  been  solved,  a  truncation  error  check  must  be  performed  on 
each  of  the  associated  system  variables.  The  truncation  error  is  assumed  negligible  if 
the  waveform  content  of  the  last  ab_nbr_wc  coefficients  of  each  waveform  is  less  than 
the  limit  specifed  by  sb_max_wc.  If  all  the  system  variables  have  negligible  truncation 
error,  block  nbr  has  been  solved  and  the  next  block  is  processed.  If  the  truncation  error 
of  any  of  the  variables  is  too  large,  converge_f ailure  is  set  to  1  to  indicate  the  block 
has  not  been  solved. 

3.4.33.3  Time  Step  Control:  Successful  Convergence 

If  all  the  blocks  successfully  obtained  a  solution  then  the  variable 
converge_£aiiure  will  equal  0.  The  task  now  is  to  save  all  of  the  variables  in  the 
history  arrays,  update  tto  and  ttl,  update  n,  and  update  the  device  states. 

Update  History  Variables 

The  history  variables  are  extended  by  one  column.  The  variable  his_coi  is 
incremented  and  is  the  column  index  for  all  but  the  state  arrays.  In  particular: 

hia_t (l,hia_col)  =  ttO 
hia_t (2,his_col)  =  ttl 

hia_N(l,hia_col)  =  K 

hia_nd_nbr(l :N,hia_col)  =  var_nd_nbr 
his_fv_naune  (1  :N,hia_col)  =  var_fv_naoe 

his_s_name ( : , his_col+l)  =  dev_al_name 
dev_a  0_name  =  dev_al_nanie 

where  (1  :N,hia_col)  refers  to  the  first  n  rows  of  column  hia_col  and  ( : ,his_col+l) 
refers  to  all  the  rows  of  column  hia_col  +  1. 

Update  Time  Interval  and  Number  of  Coefficients 

The  time  interval  is  updated  by: 

ttO  =  ttl 

If  tto  >ti  then  the  simulation  has  successfully  completed  and  the  time  loop  is 
exited.  Otherwise  must  update  ttl  as  well.  Initially: 

ttl  =  ttl  +  ddt 
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Next,  check  if  a  break  point  (element  of  sb_bp)  exists  between  ttO  and  ttl.  If 
such  a  break  point  exists,  set  ttl  equal  to  the  earliest  break  point  after  ttO. 

Since  reducing  n  is  normally  beneficial,  if  ttl  -  ttO  >  sb_dt_opt imum  and 
n  >  sb_N_min  the  algorithm  assumes  the  waveforms  are  well  behaved  and 
decrementing  n  (as  long  as  n  >  sb_n_min)  is  appropriate. 

Since  the  series  converged  for  the  previous  time  increment,  setting  ddt  equal  to  the 
minimum  of  2xddt  and  sb_dt_max  allows  the  system  to  increase  the  next  time  interval. 

Plot  Intermediate  Results 

Before  proceeding  to  solve  the  system  over  the  updated  time  interval,  WAVESEM 
creates  a  plot  of  the  system  variables  over  the  previous  time  interval. 


-93- 


3.43.2.4  Time  Step  Control:  Unsuccessful  Convergence 

Fatal  Error 

If  one  of  the  blocks  failed  to  converge,  tti  -  tt2  <  sb_dt_min,  and 
n  >  sb_n_max  then  the  simulation  has  failed  completely  and  can  not  proceed  further.  In 
this  case,  the  simulation  comes  to  a  halt  prematurely. 

Recommended  Recalculation  Time 

If  one  of  the  blocks  failed  to  converge  and  tree  <  tti,then  ttl  =  tree  and  the 
time  loop  is  repeated. 

Time  Increment  /  Number  of  Coefficient  Control 

If  one  of  the  blocks  failed  to  converge  and  tree  >  ttl, 
ttl  -  ttO  <  sb_dt_opt imun  and  N  <  sb_n_max,  n  is  incremented  in  an  attempt  to 
improve  convergence.  To  improve  convergence  if  ttl  -  tto  >  sb_dt_optimum  or 
n  >  sb_n_max,  the  time  interval  is  halved  by  setting  ttl  =  (ttl  +  tt0)/2.0. 
Halving  ddt  is  also  prudent  as  long  as  ddt  >  sb_dt_min.  Once  ddt  and  n  have  been 
updated,  the  time  loop  is  continued. 

3.4.33  Simulation  Wrap-up 

Once  the  simulation  has  completed,  the  variables  stored  in  the  history  arrays  are 
plotted  and  saved  as  the  user  desires.  If  the  operator  desires,  the  device  state  variables 
can  be  used  as  the  initial  conditions  for  a  following  simulation  or  saved  in  file  for  future 
simulations. 
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3.5  Device  Modelling  Techniques 

The  previous  sections  described  the  method  WAVESIM  uses  to  generate  a 
mathematical  system  of  equations  and  variables  for  interconnecting  a  number  of  different 
devices.  Up  to  now  a  device  has  been  treated  as  a  black  box  characterized  by  its  definition, 
initialization,  variables  which  must  be  provided  to  it  as  resources  and  variables  which  are 
generated  by  it  as  products.  As  a  review,  here  ate  properties  of  the  black  box. 

Definition  (device .  def) 

Name  of  Device  Type 

Number  of  Parameters 
Names  of  Parameters 
Default  Values  of  Parameters 

Number  of  States 
Names  of  States 

Default  Values  of  State  Initial  Conditions 

Number  of  terminals 
Terminal  Definitions 
Terminal  Name 

Terminal  Type  (normal  or  information) 

Flow  Variable  Type  (import  or  export) 

Potential  Variable  Type  (import  or  export) 

Terminal  KCL  Group  Number 

Device  Structural  Jacobian 

Initialization  (WAVESIM  input  file) 

Name  of  Device 

Name  of  defining  Device  Type 

Parameter  Values 

State  Initial  Conditions 

Assignment  of  terminals  to  nodes 
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Resources  (Arguments  of  MATLAB  device. m  file) 

Waveform  type 

Import  Variable  Waveforms 

Parameter  Values 

Value  of  states  at  beginning  of  time  interval 
Time  Structure 

Beginning  time  of  Interval 
Ending  time  of  interval 
Minimum  time  interval  of  interest 
Continuation  Parameter 

Products  (Products  of  MATLAB  device. m  file) 

Export  Variable  Waveforms 
Device  Jacobian  Matrix 
Value  of  states  at  end  of  time  interval 
Recommended  Time  Structure 

Recommended  Recalculation  Time  this  interval 
Recommended  ending  time  of  next  interval. 

While  these  specifications  are  the  hard  requirements  for  developing  a  new  device  type, 
they  are  not  very  constraining  and  it  is  possible  to  generate  very  inefficient  and  unworkable 
devices.  The  following  sections  are  meant  as  guidance  for  developing  new  device  types. 
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3.5.1  Import  and  Export  Variable  definitions 

One  of  the  first  tasks  in  designing  a  new  object  is  determining  which  variables  should 
be  import  variables  and  which  should  be  export  variables.  The  requirement  is  simply  that 
the  total  number  of  export  variables  associated  with  normal  terminals  must  equal  the  total 
number  of  import  variables  associated  with  normal  terminals.  To  minimize  the  number  of 
system  equations  however,  one  should  usually  try  to  define  flow  variables  as  export 
variables  and  potential  variables  as  import  variables. 

The  constitutive  equations  defining  a  device  may  preclude  defining  all  the  flow 
variables  as  export  variables.  An  ideal  voltage  source  of  magnitude  Vs  for  example,  has 
the  following  constitutive  equations: 

V,  =  v:  +  vs 
/,=-/2 

Clearly,  this  set  of  equations  can  not  be  reorganized  to  specify  both  currents  (flows) 
explicitly.  In  this  case  potential  V,  and  flow  I2  are  export  variables  and  potential  V2  and 
flow  I 2  are  import  variables. 
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3.5.2  Interface  Variable  Units 


When  developing  devices,  a  consistent  convention  for  interface  variable  units  is 
required.  Flows  are  usually  referenced  such  that  positive  flow  into  a  terminal  with  a 
positive  potential  refers  to  power  dissipated  by  the  device.  This  definition  is  clear  if  the 
flow  corresponds  to  currents  or  forces,  but  is  less  clear  for  torques.  For  rotating  shafts 
where  torques  are  the  flow  variable  and  rotational  speed  the  potential,  the  positive 
direction  for  speed  is  in  the  normal  operating  direction  while  the  direction  for  torque  is 
determined  by  the  power  dissipation  rule.  A  motor  connected  to  a  propeller  would 
normally  have  associated  a  positive  rotational  speed  and  a  negative  torque.  The  propeller 
would  have  a  positive  rotational  speed  and  a  positive  torque  associated  with  its  interaction 
with  the  motor  along  with  a  positive  forward  speed  and  negative  force  associated  with  its 
interaction  with  the  ship  dynamics.  The  ship  dynamics  model  would  have  an  associated 
positive  force  and  positive  forward  speed. 

Many  power  system  simulations  go  through  great  effort  to  normalize  all  variables  by 
dividing  by  device  base  quantities  to  improve  numerical  accuracy.  The  models  are  all 
expressed  in  a  Per  Unit  (PU)  basis  where  the  base  quantities  are  machine  ratings.  The 
problems  occur  when  several  devices  with  different  base  quantities  are  combined.  The 
system  variables  must  all  be  scaled  appropriately  to  ensure  the  elements  of  the  system 
equations  are  all  in  the  same  units.  Keeping  the  bases  consistent  requires  much  effort  and 
is  very  prone  to  error. 

In  WAVESIM,  physical  quantities  using  the  metric  system  (SI)  are  recommended  for 
all  interface  variables.  Stria  use  of  the  metric  system  ensures  the  proper  quantities  are 
added  and  subtracted  on  the  systems  level.  Individual  devices  may  then  scale  the  interface 
variables  by  their  own  base  quantites  for  internal  calculations.  Likewise,  each  node  of  the 
system  can  have  a  scaling  faaor  assigned  to  it  for  both  flow  and  potential  variables.  In  this 
manner,  the  beneficial  aspeas  of  the  per  unit  system  can  be  retained  with  little  confusion 
as  to  ensuring  consistent  base  quantities. 
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Metric  System  (SI) 


Le  ”th 

meters 

Time 

seconds 

Mass 

kilograms 

Voltage 

volts 

Current 

amperes 

Force 

newtons 

Angle 

radians 

Speed 

meters/second 

Rotational  Speed 

radians/second 

Torque 

newton-meters 

-99- 


3.5.3  Potential  References 

The  node  potentials  are  all  referenced  to  an  arbitrary  value  called  0.  The  reference 
frame  for  this  level  is  a  property  of  the  device  definition,  but  must  be  consistent  with  the 
reference  frame  for  other  device  definitions  to  which  the  device  may  be  connected. 
Following  are  suggested  reference  points: 

Electrical  Voltage  Volts  above  Ground  Potential 

Mechanical  Angle  Radians  relative  to  the  positive  vertical 

Mechanical  Rotational  Radians  per  Second  relative  to  stationary 
Speed 

Mechanical  System  Dependent 

Displacement 

Mechanical  Speed  meters  per  second  relative  to  stationary 

If  mechanical  rotational  speeds  or  mechanical  speeds  are  specified,  but  the  actual  angle  is 
required  within  the  device  calculations,  the  speed  can  be  integrated.  If  more  than  one 
device  requires  the  integration  of  the  speed,  then  the  system  modeller  must  ensure  the  state 
initial  conditions  corresponding  to  the  angle  or  displacement  is  consistent  for  all  devices. 

If  an  absolute  reference  cannot  be  established  for  a  device,  two  terminals  can  be 
defined  such  that  all  constitutive  relations  depend  only  on  the  difference  between  the  two 
terminal  potentials.  This  relative  definition  of  potentials  is  commonly  used  for  modelling 
circuit  elements.  An  ideal  transformer  for  example,  is  a  four  terminal  device  with  the 
following  constitutive  equations: 

Vlp  =  »(VJp-V2J  +  Vlm 

*iP  =  -  fi- 
hP  =  -  *2» 

Note  that  Vip  is  defined  relative  to  Vlm  and  is  a  function  of  (V2p  -  V2m).  None  of  the  export 
flow  v?riables  is  a  function  of  the  absolute  value  of  any  of  the  potentials. 
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3.5.4  Discontinuity  Control 


One  of  the  difficulties  with  using  vectors  of  orthogonal  series  coefficients  to 
represent  waveforms  is  the  poor  truncation  error  performance  when  approximating 
discontinuous  variables  or  variables  having  discontinuous  derivatives.  These 
discontinuities  are  usually  a  function  of  either  time  or  the  zero  crossing  of  one  of  the 
variables.  In  any  case,  the  time  of  the  discontinuity  is  often  easily  determined  by  the 
device  object.  If  the  frequency  of  the  discontinuities  is  low  enough,  it  would  be  prudent 
for  the  device  to  specify  the  earliest  discontinuity  of  the  interval  as  a  recommended 
recalculation  time. 

If  the  discontinuity  is  a  function  of  a  waveform  zero  crossing,  special  care  must  be 
taken  to  ensure  the  device  does  not  continously  estimate  the  zero  crossing  to  be  within  a 
small  increment  of  ttO  or  ttl  and  force  the  time  loop  to  iterate  tti  around  the 
discontinuity.  One  way  around  this  problem  is  for  the  device  to  move  or  remove  any 
discontinuities  within  sb_dt_ave  of  either  ttO  or  ttl  in  any  of  its  export  variables.  If 
sb_dt_ave  is  small  enough,  then  moving  the  discontinuity  should  not  affect  the  accuracy 
of  the  simulation  very  much  yet  still  prevent  the  system  time  loop  from  hunting  for  the 
discontinuity  by  varying  ttl. 

If  many  discontinuities  occur  in  an  export  variable  more  frequently  than  sb_dt_ave, 
then  the  export  variable  should  be  smoothed.  The  smoothing  operation  calculates  the  local 
average  of  a  waveform  over  the  interval  [t-sb_dt_ave,t+sb_dt_ave].  In  this  manner,  the 
higher  order  terms  of  the  export  variable  are  attenuated  and  the  waveform  is  more  likely  to 
pass  the  truncation  error  test. 
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3.5.5  Consistent  Initial  Conditions 

Most  simulation  environments  require  the  user  to  specify  the  initial  values  for  all  the 
states  at  time  to.  In  this  regard  WAVESIM  is  no  different.  Unfortunately,  determining  a 
consistent  set  of  initial  conditions  which  meet  some  definition  of  normal  operating 
conditions  is  not  an  easy  task  for  either  a  system  modeler  or  a  computer  program.  First  of 
all,  the  concept  of  a  normal  operating  condition,  is  not  always  easy  to  describe 
mathematically.  Furtheimore,  even  if  a  definition  for  normal  operating  condition,  can  be 
made,  there  is  often  much  difficulty  in  determing  that  condition. 

An  ideal  solution  would  be  for  each  device  to  calculate  its  own  initial  conditions 
during  the  first  time  increment.  If  a  device  is  capable  of  determining  an  initial  condition 
based  only  on  its  parameters  and  the  values  of  its  import  variables,  then  the  following 
technique  can  be  used: 

1.  Define  a  state  called  ic,  always  initialize  it  to  0. 

2.  Define  Sufficient  Parameters  to  determine  the  normal  operating  condition. 

3.  Within  the  constitutive  equations,  have  a  check  for  the  initial  value  of  ic 
equalling  zero.  If  ic  =  0  at  the  beginning  of  the  interval  then  use  the 
equations  for  the  normal  operationg  condition  to  determine  the  initial  values  of 
the  other  states.  Otherwise  use  the  initial  values  of  the  other  states  as  passed  to 
the  device.  In  any  case,  the  final  value  for  the  state  ic  should  be  set  to  1. 

This  method  for  determining  the  initial  conditions  is  well  suited  for  determining  the 
initial  conditions  of  the  states  of  rotating  machines.  Essentially,  a  load  flow  is  conducted 
in  the  first  time  increment  to  determine  the  initial  state  values. 
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3.5.6  Waveform  type  conversion 

Performing  the  calculations  for  the  constitutive  equations  for  certain  devices  may  be 
easier  to  accomplish  in  one  waveform  over  other  waveforms.  Converting  the  import 
variables  to  a  fixed  waveform  type  is  permissible  and  at  times  desirable.  As  long  as  the 
export  variables  are  converted  back  to  the  proper  type  and  the  jacobians  reflect  the 
waveform  conversions,  all  should  work  out  well. 

If  the  export  variables  depend  on  higher  order  terms  of  intermediate  calculations, 
convening  the  import  variables  to  waveforms  of  a  length  longer  than  n  and  performing  all 
of  the  intermediate  calculations  using  this  longer  length  before  truncating  back  to  H  when 
generating  the  export  variables  may  be  desirable  in  avoiding  excessive  truncation  errors. 
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Chapter  4  WAVESIM 
4.1  Basic  Description 

WAVESIM,  a  simulation  program  written  in  the  C  programming  language, 
demonstrates  the  algorithms  discussed  in  detail  in  Chapter  3  for  simulating  systems  of 
nonlinear  lumped  parameter  models  representing  the  electro-mechanical  components 
comprising  an  Integrated  Electric  Drive  system.  The  general  characteristics  of  WAVESIM 
are: 

1.  System  and  Simulation  Parameters  specified  in  a  text  Input  File. 

2.  Device  Definitions  are  in  text  file  device .  def . 

3.  WAVESIM  Performs  following  4  tasks: 

A.  Reads  in  Device  Definitions  and  initializes  simulation. 

B.  Reads  Input  File  and  determines  devices  and  nodes  of  system. 

C.  Builds  and  reduces  system  into  a  sequence  of  blocks. 

D.  Writes  a  MATLAB  script  file  for  conducting  the  simulation. 

4.  The  actual  Simulation  is  conducted  in  MATLAB. 

5.  Supported  Waveform  types  are: 

A.  Data  Series. 

B.  Fourier  Series. 

C.  Legendre  Series. 

D.  Polynomial  Expansions. 

E.  Chebyshev  Series. 

6.  Waveform  operators  are  MATLAB  functions  defined  in  M-files. 

7.  Device  Constitutive  Equations  are  detailed  in  MATLAB  functions  defined  in 
M-files. 

8.  The  present  Incarnation  of  WAVESIM  has  these  limitations: 

A.  Subsystems  have  not  been  implemented. 

B.  System  and  Device  Structural  Jacobians  must  be  time  independent. 

C.  Newton-Raphson  is  the  only  equation  solving  method  used. 

Relaxation  Techniques  have  not  been  implemented. 
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MATLAB  was  chosen  as  the  environment  for  conducting  the  simulation  for  the 
following  reasons: 

1.  MATLAB  is  ideally  suited  for  treating  vectors  and  matrices  as  abstract  data 
types. 

2.  MATLAB  has  built  in  plotting  routines. 

3.  The  ability  to  create  MATLAB  M-files  which  when  invoked,  execute  a  long 
series  of  commands  called  a  script.  M-files  can  also  be  used  to  create  new 
MATLAB  functions. 

4.  MATLAB  has  many  built  in  functions  for  analysing  matrix  properties. 

5.  Since  WAVESIM  is  an  algorithm  demonstration  program,  speed  is  not  of 
primary  concern.  Interest  in  determining  if  the  algorithms  work  is  of  higher 
interest  than  optimizing  for  speed. 
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4.2  Running  WAVESIM 


Under  either  the  UNIX  operating  system  or  IBM  DOS,  WAVESIM  is  executed  by 
entering  at  the  commmand  prompt: 

athena%  wavesim  file. in 

where  file .  in  is  an  optional  entry  for  the  file  name  of  the  input  file.  WAVESIM 
will  attempt  to  read  in  the  device. def  file  and  if  successful,  will  display  the  following 
header. 

WAVESIM 

Revision  2.0  <>  April  1991 

(C)  Copyright  1990,1991  by  Norbert  H.  Doerry 

If  WAVESIM  encountered  errors  when  reading  device .  def,  an  error  message  is 
printed  and  the  program  terminates. 

If  file .  in  was  not  specified  on  the  command  line,  the  user  is  prompted  for  a  file 
name: 

Enter  WAVESIM  INPUT  file  name  : 

If  instead  of  a  file  name  q  is  entered,  WAVESIM  terminates  execution.  A  directory 
listing  can  be  obtained  by  entering  a  ?  followed  optionally  by  a  file  specification  (operating 
system  dependent). 

Under  normal  execution  of  WAVESIM,  there  is  no  further  interaction  with  the  user. 
WAVESIM  automatically  creates  an  output  file  having  the  same  base  filename  as 
file .  in  but  having  .  m  as  an  extension  (i.e.  file.:'n  becomes  file  .m). 

NOTE:  Do  not  create  input  files  with  .  m  extensions  as  these  files  will  be  overwritten 
by  WAVESIM.  Also  avoid  using  file  names  which  are  valid  MATLAB  functions. 

WAVESIM  provides  extensive  support  for  providing  the  user  with  feedback  through 
the  use  of  the  DEBUG  command.  Most  of  the  major  routines  in  WAVESIM  have  a  debug 
option  for  displaying  the  results  of  calculations  internal  to  WAVESIM. 
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If  errors  are  found  reading  either  device .  def  or  the  input  file,  WAVESEM  displays 
an  error  message  which  includes  the  file  name  and  the  line  number  within  the  file. 
WAVESIM  attempts  to  continue  reading  an  input  file  even  if  errors  are  detected  bui  will 
only  create  an  output  file  if  no  errors  are  encountered. 
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4.3  Input  File  Specification 


The  Input  File  describes  the  system  topology,  defines  the  device  parameters,  and 
specifies  simulation  paramaters.  The  basic  characteristics  of  the  file  are: 

1 .  ASC  II  text  files. 

2.  Lines  beginning  with  %,  #  or  !  are  ignored.  Empty  lines  are  ignored  as  well. 

3.  Data  lines  can  be  continued  on  the  following  line  if  the  last  characters  in  the  line 
are  ...  or  \. 

4.  Commands  all  begin  with  a  key-word.  Key-words  are  case  insensitive  and 
usually  can  be  truncated  to  three  letters  unless  a  conflict  with  another  key-word 
exists. 

5.  Commands  and  their  arguments  may  be  separated  by  either  spaces  or  tabs. 

6.  The  contents  of  other  files  can  be  incorporated  by  using  the  INCLUDE  command. 

7.  Single  Line  Commands  have  data  arguments  entered  on  only  one  line. 

8.  Multiple  Line  Commands  consist  of  groups  of  subordinate  commands.  The  group 
must  end  with  a  line  beginning  with  the  key-word  END. 

Here  is  a  summary  of  the  Commands  available  : 


DEBUG 

Print  Debug  Information 

DEFAULT 

Default  System  Parameter  Initialization 

DEVICE 

Device  Specification 

INCLUDE 

Include  another  file 

NODE 

Node  Parameter  Specification 

TIME 

Time  Increment  Control 
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Example  Input  File 


% 

%  rcrc.in 

% 

debug 

build_system_identify 

build_system_blocks 

find_block 

END 

% 

device  VDC_SOURCE  Vs 
TERMINAL  1  1 
TERMINAL  2  0 
PARAMETER  VS  1 . 0 
END 

% 

device  RESISTOR  R1 
TERMINAL  1  1 
TERMINAL  2  2 
PARAMETER  R  0.1 

END 

% 

device  RESISTOR  R2 
TERMINAL  1  2 
TERMINAL  2  3 
PARAMETER  R  1.0 

END 

% 

device  INDUCTOR  LI 
TERMINAL  1  2 
TERMINAL  2  0 
PARAMETER  L  1.0 

END 

% 

device  INDUCTOR  L2 
TERMINAL  1  3 
TERMINAL  2  0 
PARAMTER  L  1.0 

END 

% 

device  CAPACITOR  Cl 
TERMINAL  1  2 
TERMINAL  2  0 
PARAMETER  C  1.0 

END 

% 

device  CAPACITOR  C2 
TERMINAL  1  3 
TERMINAL  2  0 
PARAMETER  C  1.0 

END 

% 
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Example  Input  File  (continued) 


% 

node  1 

scale  potential  1.0 
scale  flow  1.0 

error  kcl  5e-3 

error  pot  5e-3 

end 

% 

default 

Gmin  0 
Rmin  0 

check  both 

error  eqn  kcl  5e-3 
error  eqn  pot  5e-3 
error  var  node  5e-3 
error  var  flow  5e-3 
error  mult  kcl  10.0 
error  mult  pot  10.0 
error  mult  node  10.0 
error  mult  flow  10.0 

scale  potential  1.0 
scale  flow  1.0 

max  count  10 
max  int  count  6 

alpha  init  1.0 
alpha  inc  init  .25 
alpha  inc  min  .05 

diverge  start  3 
diverge  max  cnt  2 
diverge  error  mult  10.0 

waveform  content  max  .005 
waveform  content  nbr  2 

wtype  3 

nbr  coef  7 
nbr  coef  min  6 
nbr  coef  max  14 
nbr  data  20 

END 

ime 

dt  min  0.025 
dt  max  5 . 0 
dt  opt  0.250 
dt  init  1 . 0 
dt  ave  0 . 0 
start  0.0 
finish  20.0 
END 
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4.3.1  DEBUG 


If  DEBUG  is  specified  without  any  arguments,  the  command  is  interpreted  as  a 
multi-line  command.  Each  of  the  following  lines  should  contain  the  name  of  one  of  the 
subroutines  listed  below.  If  the  key-word  OFF  follows  the  subroutine  name,  the  debug  flag 
for  that  subroutine  is  turned  off.  Otherwise,  the  debug  flag  for  the  specified  routine  is 
tinned  on.  The  last  line  of  the  group  should  begin  with  the  key-word  END. 

if  DEBUG  is  specified  with  arguments,  the  command  is  interpreted  as  a  single-line 
command  and  the  arguments  should  consist  of  one  of  the  subroutines  listed  below  and 
optionally,  the  key-word  OFF.  A  single  line  command  does  not  have  an  END  keyword 
associated  with  it. 

Here  is  a  list  of  subroutines  for  which  debug  flags  have  been  defined  (Note:  The 
subroutine  names  are  case  sensitive) 

init_devices 

read_device_def 

read.__fi.le 

read_file_devi.ce 

read_file_default 

r  ead_f  i  le_node 

r  ead_f  i  le_tiaie 

read_f i le_debug 

build_system 

bui ld_sy a t em_ident i f y 

bui  ld_sy  stem_st  ructur  al_  j  acobian 

build_system_blocks 

findjblock 

print_system_identify 
write  file 
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4.3.2  DEFAULT 


If  DEFAULT  is  specified  without  any  arguments,  the  command  is  interpreted  as  a 
multi-line  command.  Each  of  the  following  lines  should  contain  one  of  the  subordinate 
commands  listed  below.  The  last  line  of  the  group  should  begin  with  the  key-word  END. 

If  DEFAULT  is  specified  with  arguments,  the  command  is  interpreted  as  a  single-line 
command  and  the  arguments  should  consist  of  one  of  the  subordinate  commands  listed 
below.  A  single  line  command  does  not  have  an  END  keyword  associated  with  it. 

Here  is  a  summary  of  the  DEFAULT  subordinate  commands: 


ALPHA 

Continuation  Parameter  Control 

CHECK 

Error  Checking  Flags 

DIVERGE 

Divergence  Test  Control 

ERROR 

Default  Error  Levels 

GMIN 

Default  Node  Leakage  Conductance 

MAX 

Maximum  Iteration  Counts 

NBR 

Number  of  Coefficients  Control 

RMIN 

Default  Node  Series  Resistances 

SCALE 

Default  Variable  Scaling  Factors 

WAVEFORM  CONTENT 

Waveform  Content  Limits 

WTYPE 

Waveform  Type 
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4.3.2.1  DEFAULT :  ALPHA 


The  ALPHA  subordinate  command  specifies  the  parameters  needed  to  control  the 
continuation  parameter  for  nonlinear  blocks. 

Command  Description  MATLAB  Variable 

ALPHA  INIT  Value  Continuation  Parameter  sb_aipha_init 

Initial  Value 

ALPHA  INC  INIT  Value  Continuation  Parameter  sb_dalpha_init 

Initial  Increment 

ALPHA  INC  MIN  Value  Minimum  Continuation  sb_dalpha_min 

Parameter  Increment 

For  a  nonlinear  block,  the  continuation  parameter  is  initialized  to  the  ALPHA  INIT 
value.  The  initial  increment  for  the  continuation  parameter  is  specified  by  ALPHA  INC 
INIT.  If  the  block  fails  to  converge,  the  continuation  parameter  is  progressively 
decremented  until  the  block  converges  or  if  convergence  fails  due  to  the  difference 
between  the  last  value  of  the  continuation  parameter  that  converged  and  the  present  value 
of  the  continuation  parameter  being  less  than  ALPHA  INC  MIN.  If  the  block  converges, 
the  continuation  parameter  is  incremented  by  ALPHA  INC  INIT  until  it  equals  1. 

4.3.2.2  DEFAULT :  CHECK 

The  CHECK  subordinate  command  determines  for  nonlinear  blocks,  whether  the 
equation  error,  the  variable  correction  magnitude,  or  both  should  be  used  for  the 
convergence  criteria. 

Command  Description  MATLAB  Variable 

CHECK  EQN  Check  only  Equation  Errors  sb_check_eqn_err  =  1 

sb_check_var_err  =  0 

CHECK  VAR  Check  only  Variable  sb_check_eqn_err  =  0 

Corrections  sb_check_yar_err  =  1 

CHECK  BOTH  Check  both  Equation  Errors  sb_check_eqn_err  =  1 

and  Variable  Corrections  sb  check  var  err  =  l 


-  113- 


4.3.2.3  DEFAULT :  DIVERGE 


The  DIVERGE  subordinate  command  specifies  when  and  how  to  check  a  nonlinear 
block  for  divergence.  After  DIVERGE  START  iterations,  if  the  largest  relative  error 
increases  for  DIVERGE  MAX  CNT  iterations  and  the  relative  error  is  at  least  DIVERGE 
ERROR  MULT  then  the  block  is  assumed  to  be  diverging  and  the  converg*_f  allure  flag 
is  set. 


Command  Description  MATLAB  Variable 

DIVERGE  START  Value  Number  of  iterations  to  wait  sb_div_start_cnt 

before  testing  for  divergence 

DIVERGE  MAX  CNT  Value  Number  of  iterations  to  sb_div_max_cnt 

allow  relative  error  to 
increase  befor  concluding 
divergence 

DIVERGE  ERR  MULT  Value  Value  of  relative  error  sb_i_div_err 

below  which  to  ignore 
divergence  iteration  count 
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4.3.2  A  DEFAULT :  ERROR 


The  ERROR  subordinate  command  determines  for  nonlinear  blocks,  the  default 
maximum  equation  errors  and  variable  corrections  which  are  permissible.  These  default 
values  can  be  overridden  for  a  specific  node  with  the  MODE  command.  When  the 
conituation  parameter  equals  1,  ERROR  EQN  KCL  is  the  maximum  error  for  the  node 
KCL  equtions  and  ERROR  EQN  POT  is  the  maximum  error  for  the  potential  difference 
equations.  Likewise  when  the  continuation  parameter  equals  1,  ERROR  VAR  MODE  is 
the  maximum  correction  to  a  node  potential  and  ERROR  VAR  FLOW  is  the  maximum 
correction  to  an  import  flow  variable.  The  ERROR  MOLT  subordinate  commands  are 
multipliers  to  the  above  limits  for  continuation  parameters  less  than  1. 

Command  Description  MATLAB  Variable 

ERROR  EQN  KCL  Value  Default  KCL  Equation  sys_kcl_errl 

Maximum  Error 

ERROR  EQN  POT  Value  Default  Potential  Difference  sys^a^err1 

Maximum  Error 

ERROR  VAR  NODE  Value  Default  Maximum  sy3_nd_err1 

correction  to  Node  ~ 

Potentials 

ERROR  VAR  FLOW  Value  Default  Maximum  sys_fv_err1 

correction  to  Import  Flow 
Variables 

ERROR  MULT  KCL  Value  Multiplier  to  ERROR  EQN  sb_i_kcl_err 

KCL  when  continuation 
parameter  <  1 

ERROR  MOLT  POT  Value  Multiplier  to  ERROR  EQN  sb_i_pot_err 

POT  when  continuation 
parameter  <  1 

ERROR  MOLT  NODE  Value  Multiplier  to  ERROR  VAR  sb_i_nd_err 

NODE  when  continuation 
parameter  <  1 

ERROR  MOLT  FLOW  Value  Multiplier  to  ERROR  VAR  sb_i_fv_err 

FLOW  when  continuation 
parameter  <  1 

Note  1:  sys_jcwc_err  are  actually  arrays  containing  for  each  equation  or  variable,  either 
the  default  value  specified  here  or  the  overriding  value  specified  in  the  NODE 
command. 
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4.3.2.5  DEFAULT :  GMIN 


The  GMIN  subordinate  command  defines  the  default  value  for  G^.  is  used  to 
modify  the  KCL  equations  to  help  prevent  singular  systems.  G ^  should  normally  be  set 
to  0  unless  a  singularity  problem  exists.  The  value  for  G can  be  overridden  for  a 
particular  node  through  the  NODE  command. 

Command  Description  MATLAB  Variable 

GMIN  Value  Leakage  Conductance  to  0  sysjSmin1 

Potential 

Note  1:  sys_Gmin  is  actually  an  array  containing  the  value  for  G^  for  each  node:  either 
the  default  value  specified  here  or  the  overriding  value  specified  in  the  NODE 
command. 

4.3.2.6  DEFAULT :  MAX 

The  MAX  subordinate  command  determines  the  maximum  number  of 
Newton-Raphson  iterations  for  a  nonlinear  block  before  the  continuation  parameter  is 
decremented.  MAX  COUNT  specifies  the  maximum  number  of  iterations  when  the 
continuation  parameter  equals  1  while  MAX  INT  COUNT  specifies  the  maximum 
number  of  iterations  when  the  continuation  parameter  is  less  than  1. 

Command  Description  MATLAB  Variable 


MAX 

COUNT  Value 

Maximum 

number  of  sb_maxcnt 

Iterations 

when  the 

continuation 
equals  1 

parameter 

MAX 

INT  COUNT  Value 

Maximum 

number  of  sb_i_maxcnt 

Iterations 

when  the 

continuation 
less  than  1 

parameter  is 
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4.3.2.7  DEFAULT :  NBR 


The  NBR  subordinate  command  controls  the  number  of  coefficients  the  waveforms 
will  have.  NBR  COEF  specifies  the  initial  number  of  coefficients  to  use.  NBR  COEF 
MIN  is  the  minimum  number  of  coefficients  to  use  while  NBR  COEF  MAX  is  the 
maximum  number  of  coefficients.  NBR  DATA  is  the  number  of  data  points  per 
waveform  used  when  generating  plots. 

Command  Description  MATLAB  Variable 

NBR  COEF  Value  Initial  number  of  n 

coefficinets 

NBR  COEF  MIN  Value  Minimum  number  of  sb_n_min 

coefficients 

NBR  COEF  MAX  Value  Maximum  number  of  sb_n_max 

coefficients 

NBR  DATA  Value  Number  of  points  per  sb_n_dat* 

waveform  to  use  in  plots. 

43.2.8  DEFAULT :  RMIN 

The  RMIN  subordinate  command  defines  the  default  value  for  R^.  is  used  to 
modify  the  Potential  Difference  equations  to  help  prevent  singular  systems.  should 
normally  be  set  to  0  unless  a  singularity  problem  exists.  The  value  for  can  be 
overridden  for  a  particular  node  through  the  NODE  command. 

Command  Description  MATLAB  Variable 

RMIN  Value  Series  Resistance  for  Export  sys_Rminl 

Potentials 

Note  1 :  sys jRmin  is  actually  an  array  containing  the  value  for  for  each  node:  either 
the  default  value  specified  here  or  the  overriding  value  specified  in  the  NODE 
command. 
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4.3.2.9  DEFAULT :  SCALE 


The  SCALE  subordinate  command  specifies  the  default  scaling  parameters  for  the 
potential  and  flow  variables.  The  default  scaling  parameters  can  be  overridden  for  a 
particular  node  through  the  NODE  command. 

Command  Description  MATLAB  Variable 

SCALE  POTENTIAL  Value  Default  scaling  factor  for  sys_pot_scaie1 

Potentials 

SCALE  FLOW  Value  Default  scaling  factor  for  sys_fiow_scaiel 

Flow  Variables 

Note  1:  sysjpot_scaie  and  sys_fiow_scaie  are  actually  arrays  containing  the  scaling 
factors  for  each  node:  either  the  default  values  specified  here  or  the  overriding 
values  specified  in  the  NODE  command. 

4.3.2.10  DEFAULT :  WAVEFORM  CONTENT 


The  WAVEFORM  CONTENT  subordinate  command  controls  the  maximum 
allowable  truncation  error  by  specifying  the  maximum  waveform  content  WAVE  CONT 
MAX  for  the  last  WAVE  CONT  NBR  coefficients  of  a  waveform. 


Command 

WAVE  CONT  MAX  Value 

WAVE  CONT  NBR  Value 


Description  MATLAB  Variable 

Maximum  Waveform  sb_max_hh 

Content 

Number  of  Coefficients  to  sb_nbr_hh 
apply  maximum  to. 


4.3.2.11  DEFAULT:  WTYPE 

The  WTYPE  subordinate  command  specifies  the  waveform  type  to  use  in  the 
simulation 

Command  Description  MATLAB  Variable 

WTYPE  Value  Waveform  Type  Indicator  "type 

1  Data  Series 

2  Fourier  Series 

3  Legencre  Series 

4  Polynomials 

5  MATLAB  Polynomials 

6  Chebyshev  Series 
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4.3.3  DEVICE 


DEVICE  is  always  a  multi-line  command.  The  command  must  be  entered  in  the 
following  format: 

DEVICE  Device__Type  Name 

where: 

Device_Type  Device  Type  Name  from  device .  def  file. 

Name  Name  of  this  particular  device. 

The  subordinate  commands  for  the  DEVICE  command  are: 

TERMINAL  Assign  Terminals  to  Nodes  (mandatory). 

PARAMETER  Assign  Parameter  Values  (optional). 

STATE  Assign  State  Initial  Conditions  (optional). 

All  of  the  terminals  as  defined  in  the  device .  def  must  be  assigned  to  a  node.  If  the 
parameters  or  states  are  not  assigned  values,  the  default  values  specified  in  device .  def 
are  used. 

The  last  line  of  the  command  group  must  begin  with  the  key-word  END 

4.3.3.1  DEVICE :  TERMINAL 

The  TERMINAL  subordinate  command  assigns  a  terminal  to  a  node  and  must  be 
entered  in  the  following  format: 

TERMINAL  Terminal_Name  Node_Nbr 

where: 

Terminal_Name  Terminal  Name  from  device .  def  file. 

Node_Nbr  Serial  Number  of  Node  this  terminal  is  attached  to. 

All  of  the  terminals  as  defined  in  device .  def  must  be  attached  to  a  node  of  the 
system. 
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4.33.2  DEVICE :  PARAMETER 

The  PARAMETER  subordinate  command  assigns  a  value  to  a  parameter  of  the 
device.  If  the  parameter  is  a  single  value  as  defined  in  device .  def  then  the  parameter 
command  must  be  of  the  following  format: 

PARAMETER  Parameter__Niuae  Value 

where: 

Parameter_Name  Parameter  Name  from  device .  def  file. 

Value  Parameter  Value. 

If  the  parameter  is  a  matrix  as  defined  in  device .  def  then  the  parameter 
command  must  be  of  the  following  format: 

PARAMETER  Parameter_Name  MATRIX 
matrix_values 
END 

where: 

Parameter_Name  Parameter  Name  from  device .  def  file. 

matrix_values  Parameter  matrix.  The  number  of  rows  and  columns 

of  the  matrix  must  be  the  same  as  specified  in  the 
device .  def  file.  Rows  are  entered  one  line  at  a 
time  with  columns  separated  by  spaces. 

If  a  parameter  as  defined  in  device .  def  is  not  assigned  a  value,  then  the  default 
values  specified  in  device .  def  is  used. 
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4.3.3.3  DEVICE :  STATE 


The  STATE  subordinate  command  assigns  an  initial  value  to  a  state  of  the  device 
and  must  be  entered  in  the  following  format: 

STATE  State_Name  Value 

where: 

State_Name  State  Name  from  device .  def  file. 

Value  Initial  value  of  state. 

If  a  state  as  defined  in  device. def  is  not  assigned  a  value,  then  the  default 
values  specified  in  device .  def  is  used. 
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4.3.4  INCLUDE 


INCLUDE  is  always  a  single-line  command.  The  command  must  be  entered  in  the 
following  format: 

INCLUDE  File_Name 

where: 

File  Name  Name  of  the  file  to  include. 

The  contents  of  the  included  file  are  inserted  at  the  location  of  the  INCLUDE 
command. 

4.3.5  NODE 

NODE  is  always  a  multi-line  command.  The  command  must  be  entered  in  the 
following  format: 

NODE  Node  Nbr 


where: 

Node_Nbr  Serial  Number  of  the  node. 

The  subordinate  commands  for  the  NODE  command  are: 


ERROR 

Node  Error  Levels 

GMIN 

Specify  node  G^-.  value 

NAME 

Assign  a  name  to  the  node 

RMIN 

Specify  node  /?„•.  value 

SCALE 

Specify  node  scaling  factors 

The  last  line  of  the  command  group  must  begin  with  the  key-word  END 
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4.3.5.1  NODE :  ERROR 


The  ERROR  subordinate  command  determines  for  nonlinear  blocks,  the  maximum 
equation  errors  and  variable  corrections  which  are  permissible.  These  values  override  the 
default  values.  When  the  conituation  parameter  equals  1,  ERROR  EQN  KCL  is  the 
maximum  error  for  the  node  KCL  eqution  and  ERROR  EQN  POT  is  the  maximum  error 
for  the  potential  difference  equations.  Likewise  when  the  continuation  parameter  equals 
1,  ERROR  VAR  NODE  is  the  maximum  correction  the  node  potential  and  ERROR  VAR 
FLOW  is  the  maximum  correction  to  an  import  flow  variable.  The  ERROR  MOLT 
subordinate  commands  of  the  DEFAULT  command  are  multipliers  to  the  above  limits  for 
continuation  parameters  less  than  1. 


Command 

ERROR  EQN  KCL  Value 
ERROR  EQN  POT  Value 
ERROR  VAR  NODE  Value 

ERROR  VAR  FLOW  Value 


Description  MATLAB  Variable 

Maximum  KCL  Equation  sy3_kcl_err1 
Error 

Maximum  Potential  sys^a^err1 

Difference  Error 

Maximum  correction  to  sys_nd_err1 

Node  Potential 

Maximum  correction  to  sys_fv_errl 

Import  Flow  Variables 
attached  to  this  node 


Note  1:  ays_jcxx_err  are  actually  arrays  containing  for  each  equation  or  variable,  either 
the  default  value  or  the  overriding  value  specified  here. 

4.3.S.2  NODE :  GMIN 


The  GMIN  subordinate  command  defines  the  value  for  G^.  Gmn  is  used  to  modify 
the  KCL  equation  to  help  prevent  singular  systems.  Gmm  should  normally  be  set  to  0 
unless  a  singularity  problem  exists.  The  value  for  G^n  overrides  the  default  value. 

Command  Description  MATLAB  Variable 

GMIN  Value  Leakage  Conductance  to  0  sys_Gmin1 

Potential 

Note  1:  sys_Qnin  is  actually  an  array  containing  the  value  for  G^  for  each  node:  either 
the  default  value  or  the  overriding  value  specified  here. 
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4.3.5 .3  NODE :  NAME 


The  NAME  subordinate  command 

Command  Description  MATLAB  Variable 

NAME  Node_Name  Name  of  the  Node  sys_node_najnel 

The  node  name  is  only  used  to  associate  the  node  serial  number  to  a  more 
understandable  label.  The  node  name  is  optional  and  does  not  affect  computation  in  any 
way. 

Note  1:  sys_node_name  is  actually  an  array  containing  the  names  of  all  the  nodes. 

4.3.5.4  NODE :  RMIN 

The  RMIN  subordinate  command  defines  the  node  value  for  is  used  to 

modify  the  Potential  Difference  equations  to  help  prevent  singular  systems.  should 
normally  be  set  to  0  unless  a  singularity  problem  exists.  The  value  for  R^*  overrides  the 
default  value. 

Command  Description  MATLAB  Variable 

RMIN  Value  Series  Resistance  for  Export  sys_Pmin1 

Potentials 

Note  1:  sya_Rain  is  actually  an  array  containing  the  value  for  R^  for  each  node:  either 
the  default  value  or  the  overriding  value  specified  here. 

4.3.5.5  NODE :  SCALE 

The  SCALE  subordinate  command  specifies  the  node  scaling  parameters  for  the 
potential  and  flow  variables.  The  scaling  parameters  override  the  default  values. 

Command  Description  MATLAB  Variable 

SCALE  POTENTIAL  Value  Scaling  factor  for  Node  sys^pot^scaie1 

Potential 

SCALE  FLOW  Value  Node  scaling  factor  for  Flow  sys_fiow_scale1 

Variables 

Note  1:  sys_pot_scale  and  sys_fiow_scaie  are  actually  arrays  containing  the  scaling 
factors  for  each  node:  either  the  default  values  or  the  overriding  values  specified 
here. 
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4.3.6  TIME 


If  TIME  is  specified  without  any  arguments,  the  command  is  interpreted  as  a 
multi-line  command.  Each  of  the  following  lines  should  contain  one  of  the  subordinate 
commands  listed  below.  The  last  line  for  the  section  should  begin  with  the  key-word  END. 

If  TIME  is  specified  with  arguments,  the  arguments  should  consist  of  one  of  the 
subordinate  commands  listed  below.  A  single  line  command  does  not  have  an  END 
keyword  associated  with  it. 

The  subordinate  commands  for  the  TIME  command  are: 


BREAK 

Insert  Break  Point 

DT 

Time  Increment  Control 

FINISH 

Ending  Time  of  Simulation 

START 

Starting  Time  of  Simulation 

4.3.6.1  TIME :  BREAK 

The  BREAK  subordinate  command  inserts  a  simulation  break  point  which  forces  a 
waveform  boundary  to  occur  at  the  designated  time.  Bracketing  intervals  in  which  a 
discontinuity  will  occur  with  breakpoints  can  reduce  the  computational  effort  required  by 

WAVESIM. 

Command 

Description 

MATLAB  Variable 

BREAK  Time 

Break  Point  time 

sb_Jbpa 

sb_bp_nbr 

Note  1:  sbjbp  is  actually  an  array  of  break  points  in  chronological  order.  sb_bp_nbr  is 
the  number  of  break  points. 
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4.3.6.2  TIME :  DT 


The  DT  subordinate  command  controls  the  waveform  interval. 

Command  Description  MATLAB  Variable 

DT  MIN  Value  Minimum  Waveform  sb_dt_min 

Increment 

DT  MAX  Value  Maximum  Waveform  sb_dt_max 

Increment 

DT  OPTIMUM  Value  Optimum  Waveform  sb_dt_optimum 

Increment 

DT  INITIAL  Value  Initial  Waveform  Increment  sb_dt_init 

DT  AVE  Value  Minimum  Time  Interval  of  sb_dt_ave 

Interest  (Averaging  Interval) 

If  the  time  interval  is  less  than  DT  OPTIMUM,  the  number  of  coefficients  is  less 
then  the  maximum  and  a  block  does  not  converge,  the  number  of  coefficients  is  increased 
for  the  next  iteration.  Otherwise,  if  the  block  does  not  converge  the  time  interval  is 
reduced. 

DT  AVE  is  the  minimum  time  interval  of  interest  and  is  used  by  devices  to  smooth 
their  export  waveforms  or  to  move  discontinuity  boundaries. 

4.3.6.3  TIME :  FINISH 

The  FINISH  subordinate  command  specifies  the  ending  time  of  the  simulation. 
Command  Description  MATLAB  Variable 

TIME  FINISH  Value  Ending  Time  of  Simulation  ti 

4.3.6.4  TIME :  START 

The  START  subordinate  command  specifies  the  beginning  time  of  the  simulation. 
Command  Description  MATLAB  Variable 

TIME  START  Value  Starting  Time  of  Simulation  to 
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4.4  Device  Definition  File  Specification 

The  device  definition  file  device.def  contains  the  definitions  of  the  device  types 
which  can  be  specified  in  a  WAVESIM  Input  File.  The  basic  characteristics  of  the  file  are: 

1 .  ASC II  text  files 

2.  Lines  beginning  with  %,  #  or  !  are  ignored.  Empty  lines  are  ignored  as  well. 

3.  Data  lines  can  be  continued  on  the  following  line  if  the  last  characters  in  the  line 
are  ...  or  \. 

4.  Commands  all  begin  with  a  key-word.  Key-words  are  case  insensitive  and 
usually  can  be  truncated  to  three  letters  unless  a  conflict  with  another  key-word 
exists. 

5.  Commands  and  their  arguments  may  be  separated  by  either  spaces  or  tabs. 

6.  The  contents  of  other  files  can  be  incorporated  by  using  the  INCLUDE  command. 

7.  Single  Line  Commands  have  data  arguments  entered  on  only  one  line. 

8.  Multiple  Line  Commands  consist  of  groups  of  subordinate  commands.  The  group 
must  end  with  a  line  beginning  with  the  key-word  END. 
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Example  device .  def  File 


« 

%  device. def 

% 

%  debug  init_devices 
debug  read  device  def 
% 

device  RESISTOR 

Terminal  1  Pot  VI  Import 

Terminal  1  Flow  II  Export  1 

Terminal  2  Pot  V2  Import 

Terminal  2  Flow  12  Export  1 

Parameter  R  le-15 
Function  resistor 
Structural  Jacobian  All 
DD 
DD 

end 

end 

% 

device  INDUCTOR 

Terminal  1  Pot  VI  Import 

Terminal  1  Flow  II  Export  1 

Terminal  2  Pot  V2  Import 

Terminal  2  Flow  12  Export  1 

Parameter  L  le-15 
Function  inductor 
Structural  Jacobian  All 
LL 
LL 

end 

end 

% 

device  CAPACITOR 

Terminal  1  Pot  VI  Export 

Terminal  1  Flow  11  Export  1 

Terminal  2  Pot  V2  Import 

Terminal  2  Flow  12  Import  1 

Parameter  C  le-15 
Function  capacitor 
Structural  Jacobian  All 
IL 
OD 

end 

end 

% 

device  VDC  SOURCE 

Terminal  1  Pot  VI  Export 

Terminal  1  Flow  II  Export  1 

Terminal  2  Pot  V2  Import 

Terminal  2  Flow  12  Import  1 

Parameter  VS  1.0 
Function  vdc  src 
Structural  Jacobian  All 
10 
OD 

end 

end 

% 

device  REFERENCE 

Terminal  Gnd  Pot  VO  Export 
Terminal  Gnd  Flow  10  Import  0 
Parameter  Vref  0.0 
Structural  Jacobian  ALL 
0 

end 

end 

% 

%  include  load  flow  definitions 
include  loadflow.def 

% 

%  include  rotating  machinery  IED  Models 
include  powersys.def 

% 

%  include  other  circuit  elements 
include  circ  elm. def 
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4.4.1  DEBUG 


The  DEBUG  command  is  always  a  single-line  command  and  results  in  the  display  of 
debug  information  for  a  specified  routine  during  the  execution  of  WAVESIM. 

Command  Description 

DEBUG  init_devices  Print  Info  on  Initial  System  Parameters 

DEBUG  read  device  def  Print  Info  on  what  is  read  from  device .  def 


4.4.2  DEVICE 


DEVICE  is  always  a  multi-line  command.  The  command  must  be  entered  in  the 
following  format: 

DEVICE  Device_Type 

where: 

Devi ce_ Type  Device  Type  Name  (must  be  unique) 

The  Device  Type  Name  is  used  to  correlate  a  given  device  in  an  input  file  with  the 
properties  of  the  device  as  specified  here.  The  subordinate  commands  for  DEVICE  are: 

TERMINAL  Specify  Terminal  Variable  Properties 

PARAMETER  Specify  Parameters 

STATE  Specify  States 

FUNCTION  Specify  MATLAB  function 

STRUCTURAL  JACOBIAN  Specify  Structural  Jacobian 

The  last  line  of  the  command  group  must  begin  with  the  key-word  END 
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4.4.2.1  DEVICE :  TERMINAL 


The  TERMINAL  subordinate  command  defines  the  properties  of  the  variables 
associated  with  a  terminal.  If  the  Terminal  is  a  normal  terminal,  both  the  flow  and 
potential  variables  need  definitions.  Flow  variables  also  require  a  KCL  group  number 
KCL  which  corresponds  to  the  group  of  terminals  for  which  KCL  can  be  written  internally 
to  the  device.  If  the  flow  variable  does  not  belong  to  a  KCL  group,  its  value  should  be  0. 
Variable  are  IMPORT  is  they  are  a  resource  to  the  device  and  are  EXPORT  if  they  are  a 
product  of  the  device.  The  total  number  of  export  variables  associated  with  normal  nodes 
must  equal  the  total  number  of  import  variables  associated  with  normal  nodes. 

Normal  Node  potentials  are  defined  by  either 

TERMINAL  Terminal_Name  POTENTIAL  Variable_Name  EXPORT 

or 

TERMINAL  Terminal  Name  POTENTIAL  Variable  Name  IMPORT 


Normal  Node  flows  are  defined  by  either 

TERMINAL  TerminalJName  FLOW  Variable_Name  EXPORT  KCL 
or 

TERMINAL  Terminal_Name  FLOW  Variable_Name  IMPORT  KCL 

Information  Node  potentials  are  defined  by  either 

TERMINAL  Terminal_Name  INFORMATION  Variable_Name  EXPORT 
or 

TERMINAL  Terminal_Name  INFORMATION  Variable_Name  IMPORT 

Where 

Terminal_Name  One  word  name  for  Terminal 

Variable_Name  One  word  name  for  Variable 

KCL  KCL  Group  Number  (0  if  none) 
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4.4.2.2  DEVICE :  PARAMETER 


The  PARAMETER  subordinate  command  defines  the  parameters  of  the  device  and 
optionally,  declares  the  default  values  for  the  parameters.  Parameters  can  either  be  single 
valued  or  a  matrix.  A  single  valued  parameter  is  defined  by: 

PARAMETER  Parameter  Name  Default  Value 


where 

Parameter__Name  One  word  name  for  Parameter 

Default_Value  Optional  Default  Value  for  Parameter 

Matrix  parameters  for  which  which  no  default  values  are  provided  are  defined  by: 

PARAMETER  Parameter  Name  MATRIX  Nbr  Row  Nbr  Col 


where 


Nbr_Row  Number  of  rows  in  Matrix 

0  should  never  be  used 
-1  indicates  variable  dimensioned 

Nbr_Col  Number  of  columns  in  Matrix 

0  should  never  be  used 
-1  indicates  variable  dimensioned 


Matrix  parameters  for  which  which  default  values  are  provided  are  defined  by: 

PARAMETER  Parameter_Name  MATRIX  Nbr_Row  Nbr_Col 
DEFAULT 

Default_Matrix 

END 


where 


Default_Matrix  Default  Matrix  values.  Each  matrix  row  should 

be  entered  one  line  at  a  time  with  columns 
separated  by  spaces. 
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4.4.2.3  DEVICE :  STATE 


The  STATE  subordinate  command  defines  the  states  of  the  device  and  optionally, 
declares  the  default  initial  values  for  the  states.  States  are  defined  by: 

STATE  Stata_Nama  Default_Value 

where 

Stata_Nama  One  word  name  for  State 

Dafaul  t_Val  ua  Optional  Default  Initial  Value  for  State 

4.4 2 A  DEVICE:  FUNCTION 

The  FUNCTION  subordinate  command  is  mandatory  and  defines  the  MATLAB 
function  which  defines  the  device  constitutive  equations.  The  MATLAB  function  is 
specified  by: 

FUNCTION  MATLAB_Function 

where 

MATLAB  Function  MATLAB  Function  name 
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4.4.2.5  DEVICE:  STRUCTURAL  JACOBIAN 


The  STRUCTURAL  JACOBIAN  subordinate  command  defines  the  structural 
jacobian  matrix  of  the  device  for  1  or  for  all  of  the  waveform  types.  The  structural 
jacobian  for  all  waveform  types  is  specified  by: 

STRUCTURAL  JACOBIAN  ALL 
Strvctural_Jacobian 
END 

where 

Stxructural_Jacobian  Structural  Jacobian  Matrix.  The  Rows 

correspond  to  Export  Variables  ordered 
according  to  the  order  of  definition.  Similarly, 
the  Columns  correspond  to  Import  Variables 
ordered  according  to  the  order  of  definition. 
The  elements  are  Structural  Jacobian  Codes 
detailed  below. 

The  structural  jacobian  for  one  particular  waveform  type  is  specified  by: 

STRUCTURAL  JACOBIAN  Wa veform__ Type 
St  ruct  ural_Jacobi  an 
END 

where 

Waveform_Typo  Waveform  Type  Code  the  structural  jacobian  is 

defined  for 
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Structural  Jacobian  Codes 


Code 

Type  of  Matrix 

0 

Zero  Matrix  (all  elements  are  always  zero) 

I 

Identity  Matrix  (always  the  identity  matrix) 

D 

Diagonal  Matrix  (always  a  linear  main  diagonal  matrix) 

L 

Linear  Matrix  (The  elements  are  always  constant) 

A 

Nonlinear  AC  Matrix  (see  Note  1) 

N 

Nonlinear  Matrix  (The  elements  may  not  be  constants) 

U 

Unknown  (The  dependence  is  unknown  (treat  as  nonlinear)) 

Note  1:  An  AC  Matrix  is  one  for  which  the  constant  component  of  the  export  variable 
depends  only  on  the  constant  component  of  the  import  variable.  The  other 
components  of  the  export  variable  can  not  depend  on  the  constant  component  of  the 
import  variable  but  are  not  restricted  in  any  other  way. 

Waveform  Type  Codes 


Waveform  Type 

-  - .  ... . . . —| 

Code  | 

I  Undefined 

0 

Data  Series 

1 

Fourier  Series 

2 

Legendre  Series 

3 

Polynomials 

4 

Matlab  Polynomials 

5  1 

Chebyshev  Series 

6  1 
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4.4.3  INCLUDE 


INCLUDE  is  always  a  single-line  command.  The  command  must  be  entered  in  the 
following  format: 

INCLUDE  File_Nama 

where: 

File_Name  Name  of  the  file  to  include. 

The  contents  of  the  included  file  are  inserted  at  the  location  of  the  INCLUDE 
command. 
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4.5  Adding  devices 

Adding  New  devices  to  WAVESIM  requires  the  creation  of  a  MATLAB  M-file 
defining  the  device  constitutive  equations  and  the  addition  of  an  entry  in  the  device .  def 
file. 

4.5.1  MATLAB  M-FILE 


Creating  a  MATLAB  M-FILE  for  generating  a  new  device  requires  adherence  to  a 
strict  function  argument  list  format.  The  following  header  indicates  the  format  required  by 
WAVESIM: 

function  [e,  jacob,  si,  ttl ]  =f  unction*  (stype, i, par,  i nparl2 ,  mpar2? ,  sO, tt,  alpha) 

% 

%  FUNCTION 
% 

% 

% 

% 

% 

% 

% 

% 

% 

% 

% 

% 

% 

% 

% 

% 

% 

% 

% 

% 

% 

% 

% 

% 


% 

% 

% 

% 

% 


VERSION  2.5  of  19  April  1991 

(C)  Copyright  1990,  1991  by  Norbert  H.  Doerry 

[e  ,  jacob,  si,  ttl]  =  function (stype, i, par, sO, tt, alpha) 

FUNCTION  creates  the  values  and  jacobian  matrix  for  a  FUNCTION 


stype  =  1  data  points 

=  2  fourier  series 
=*  3  legendre  series 
**  4  polynomial 
=  5  MATLAB  Polynomials 
«  6  chebyshev  series 

i  «  [il  i2  . . .]  where 

il,  i2,  ...  are  column  vectors  of  import  variables 


par 


[pi  p2  .  .  .  ]  where 


pi  =  parame  t  er_  I 
p2  =  paraaeter_2 


mparl  =  matrix  parameter  p*rameter_Ml 
tap*.r2  =  matrix  paraemter  parameter  A2 


sO 


=  [SO  1  SO  2 


]  where 

SO  1  =  state_l  value  at  tO 

S(f~ 2  =  state  2  value  at  tO 


tt  =  [tO  tl  dtave]  where 

tO  =  initial  time  of  the  interval 

tl  =  final  time  of  the  interval 

dtave  =  averaging  increment 

alpha  =  continuation  parameter 
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dP&dPdPdPdPdPdPdPdpdPdPdP 


e  =  [el  e2  ...]  where 

el,  e2,  . . .  are  column  vectors  of  export  variables 

jacob  =  Jacobian  matrix  of  e  with  respect  to  i 

si  =  [Sl_l  Sl_2  . . . ]  where 

Sl__l  =  state_l  value  at  tl 
SI  2  -  state  2  value  at  tl 


ttl  =  [ntl  ntt]  where 

ntl  =  recommended  recomputation  time  this  interval 
ntt  =  recommended  ending  time  next  interval 

Note  1:  function  is  the  name  of  the  function  defining  the  device.  The  MATLAB  M-FILE 
should  be  called  function .  m. 

Note  2:  mpari,  mpar2,  etc.  are  only  specified  if  the  device  as  defined  in  device .  def 
has  matrix  parameters. 
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Example  MATLAB  M-File 


function  [e  ,  jacob  ,  si,  ttl]  =  resistor (stype, i, par,  sO,  tt,  alpha) 

% 

RESISTOR 


VERSION  1.6  of  25  February  1991 
(C)  Copyright  1990,1991  by  Norbert  H.  Doerry 

[e  ,  jacob,  si,  ttl]  =  resistor  (stype,  i, par,  sO,  tt, alpha) 

resistor  creates  the  values  and  jacobian  matrix  for  a  resistor 

stype  =  1  data  points 

=  2  fourier  series 
=  3  legendre  series 
«=  4  polynomial 


1 

par 

sO 

tt 


[vl  v2]  where  vl  and  v2  are  column  vectors 
R]  where  R  is  the  resistance 

tO  tl  dt] 

tO  =  initial  time  of  the  interval 
tl  =  final  time  of  the  interval 
dt  =  averaging  time  interval 


alpha  =  continuation  parameter 


e 

jacob 

si 

ttl 


=  [il  i2]  where  il  and  i2  are  column  vectors 
=  Jacobian  matrix  of  e  with  respect  to  i 

=  [ntl  ntt]  where 

ntl  recommended  recomputation  time  this  interval 
ntt  recommended  ending  time  next  interval 


%  structural  jacobian 

% 

%  D  D 

%  D  D 

% 

n  =  size  (i) ; 
n (2)  -  []; 
tO  =  tt (1) ; 
tl  =  tt  (2)  ; 
dt  =  tt  (3) ; 

% 

ttl  =  [tl  tO]; 

% 

R  =  par  (1)  ; 

% 

si  =  []; 

% 

vl  =  i  ( : , 1)  ; 
v2  =  i ( : , 2 ) ; 

% 

11  =  (vl  -  v2)  /  R; 

12  »  *  il; 

% 

% 

e  =  [il  i2 ) ; 

% 

% 

ii  =  eye (n) ; 

% 

jacob  «■  [  ii  /  R  -ii  /  R  ;  -ii/Rii/R]; 

% 
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4.5.2  device .  def  File 


A  DEVICE  entry  must  be  made  in  the  device .  def  file  as  described  in  a  previous 
section.  Here  is  an  example  of  the  entry  made  for  the  resistor 

% 

DEVICE  RESISTOR 

% 

TERMINAL  1  POTENTIAL  VI  IMPORT 

TERMINAL  1  FLOW  II  EXPORT  1 

TERMINAL  2  POTENTIAL  V2  IMPORT 

TERMINAL  2  FLOW  12  EXPORT  1 

PARAMETER  R  le-15 
FUNCTION  resistor 
STRUCTURAL  JACOBIAN  ALL 
DD 
DD 

END 

END 

Note:  a  device  can  be  have  multiple  entries  in  device. def  to  reflect  different 
default  state  initial  values  and  default  parameter  values.  For  example,  one  may  desire  to 
create  a  model  of  a  1000  ohm  resistor. 

% 

DEVICE  1 K_RE S I STOR 

% 

TERMINAL  1  POTENTIAL  VI  IMPORT 

TERMINAL  1  FLOW  II  EXPORT  1 

TERMINAL  2  POTENTIAL  V2  IMPORT 

TERMINAL  2  FLOW  12  EXPORT  1 

PARAMETER  R  1000 
FUNCTION  resistor 
STRUCTURAL  JACOBIAN  ALL 
DD 
DD 

END 

END 

In  this  manner,  one  can  develop  devices  which  reflect  the  specific  operating 
parameter  of  a  particular  model.  A  Gas  Turbine  model  for  example,  could  be  called 
GT_501K-17  and  have  all  the  parameters  prespecified  for  an  Allison  501K-17  Gas 
Turbine. 
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4.6  Adding  Waveform  Types 

Adding  a  new  waveform  type  requires: 

1.  Assignment  of  a  waveform  type  code. 

2.  Writing  MATLAB  M-File  functions  for  converting  to  and  from  the  other 
waveform  types. 

3.  Modification  of  wconvert .  m 

4.  Writing  MATLAB  M-FILE  functions  for  accomplishing  the  waveform 
operations  required  by  the  devices 

5.  Modificaiton  of  *  function .  m  files 
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4.6.1  Conversion  M-Files 


Here  is  an  example  of  a  conversion  M-File  for  converting  a  Legendre  Series  into  a 
Polynomial: 

function  [poly,  jacob]  =  leg_poly (leg, n) 

% 

%  [poly,  jacob]  =  leg_poly (leg,n) 

% 

%  Norbert  H.  Doerry 

%  Revision  1.1  21  November  1990 

% 

%  LEG_POLY  converts  a  Legendre  Series  to  a  Normal  Polynomial 
%  leg  =  vector  of  Legendre  Series  Coefficients  in  ascending 
%  order 

%  n  =  size  of  polynomial  array  to  create 

% 

%  poly  =  answer 

%  jacob  =  partial  derivative  of  poly  wrt  leg 

% 


nl  = 

size (leg) ; 

nl  (2) 

=  []; 

% 

if  n 

A 

II 

O 

n2  - 

:  nl; 

else 

n2  = 

:  n; 

end 

% 

%  build  the  jacobian 

% 

jacob  =  zeros (n2,nl) ; 

% 

if  nl  >  n2 
nn  =*  n2; 
else 
nn  -  nl; 
end 
% 

for  i=l:nn 

jacob (l:i,i)  =  legendre (i-1) ; 
end 

% 

poly  =  jacob  *  leg; 

% 

% 

% 
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Note  that  a  jacobian  matrix  must  be  specified  for  each  result  with  respect  to  each 
argument.  Here  is  the  current  version  of  wconvert .  m  which  is  the  normal  method  for 
accessing  the  conversion  routines: 


function  [w2, jacob]  =  wconvert <wl,n, si, s2) 

% 

WCONVERT 


VERSION  1.3  of  26  March  1991 
(C)  Copyright  1990.1991  by  Norbert  H.  Doerry 

[w2, jacob]  =  wconvert *wl,  n,  si,  s2) 

WCONVERT  converts  a  waveform  of  one  type  to  another  type  and 
also  returns  the  jacobian  of  the  conversion: 

w  =  input  waveform 

n  =  number  of  points  in  output  waveform 

si  =  type  of  input  waveform 

=*  1  data  points 
=  2  fourier  series 
=  3  legendre  series 
=  4  polynomial 

=  5  for  matlab  polynomial  (not  implemented  yet) 
=  6  chebyshev  series 

s2  =  type  of  output  waveform 


nl  «  size(wl); 
nl (2)  =  []; 
if  n  <  1 
n2  =  nl; 
else 

n2  =  n; 
end 
% 

% 

if  si  <  1  I  si  >  6 

'Illegal  waveform  type' 
si 

return; 

end 

if  32  <  1  I  s2  >  6 

'Illegal  waveform  type' 
s2 

return; 

end 

if  si  ==  5  |  s2  ==  5 

'Illegal  waveform  type' 
s2 

return; 

end 

% 
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p-<#> 


f 


si  ==  1 
if  s2  —  1 

[w 2,  jacob] 
return; 

elseif  s2  =  2 
(w2,  jacob] 
return; 

elseif  s2  ==  3 
[w 2,  jacob] 
return; 

elseif  s2  =  4 
[w2,  jacob] 
return; 
else 

[w2,  jacob] 
return; 


end 


datadata (wl,  n2) ; 
datafour (wl,n2) ; 
data_leg (wl,n2) ; 
datapoly (wl, n2) ; 
datacheb (wl, n2) ; 


elseif  si  ==  2 
if  s2  =  1 

[w2,  jacob] 
return; 

elseif  s2  =  2 
[w2,  jacob] 
return; 

elseif  s2  =  3 
[w2,  jacob] 
return; 

elseif  s2  *==  4 
[w2,  jacob] 
return; 
else 

33!.. 

=  31 
return; 

end 


W9' 

,w2, 

jacob 


* 


fourdata (wl, n2) 

fourfour (wl, n2) 

f our_leg ( wl , n2 ) 

f ourpoly ( wl , n2 ) 

f ourpoly ( wl , n2 ) 
jDolycheb  (w3, n2) 


elseif  si  ==  3 

if  s2  —  1 

[w2,  jacob] 
return; 

elseif  s2  =•  2 
[w2,  jacob] 
return; 

elseif  s2  =”  3 
[w2,  jacob] 
return; 

elseif  s2  ==*  4 
[w2,  jacob] 
return; 

else 

[w2,  jacob] 
return; 

end 


leg_data (wl,n2) ; 
leg_four (wl, n2) ; 
leg_leg ( wl , n2 ) ; 
leg_poly ( wl , n2 ) ; 
leg_cheb ( wl ,  n2 ) ; 


% 

elseif  si  =*  4 

if  s2  =  1 

[w2,  jacob] 
return; 

elseif  s2  ==■  2 
[w2,  jacob] 
return; 

elseif  s2  =  3 
[w2,  jacob] 
return; 

elseif  s2  =■  4 
[w2,  jacob] 
return; 

else 

[w2,  jacob] 
return; 

end 


=  polydata (wl, n2) ; 
=  polyfour (wl, n2) ; 
»  poly_leg (wl, n2) ; 
=  polypoly (wl, n2) ; 
=  polycheb (wl, n2) ; 
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else 

if  s2  =  1 
[w2, jacob] 
return; 
elseif  s2 
[w3. 


(w2 
;jacob 


■M  .. 

ob  =  3: 


return; 
elseif  s2  = 
[w2, jacob] 
return; 
elseif  s2  = 
[w2, jacob] 
return; 
else 

[w2, jacob] 
return; 
end 


2 


3 

4 


end 


chebdata (wl, n2) 

chebpoly (wl, 0) ; 
polyf our (w37  n2) 

j3; 

cheb_leg (wl, n2) 
chebpoly (wl , n2 ) 
leg_leg (wl, n2) ; 


4.62  Waveform  Functions 


Waveform  functions  are  defined  in  a  similar  manner  to  the  conversion  files.  Here  is 
an  example  of  a  MATLAB  M-File  for  integrating  a  polynomial: 


function 

% 

% 

%  lp2  , 
% 


[p2  ,  jacob]  «=  poly_int  (pl,  n,  c) 
jacob]  =  poly_int (pi/ n, c) 


%  Norbert  H.  Doerry 
%  Revision  1.0  of  6  December  1990 


% 

%  pi  =  input  polynomial 
%  n  =  number  of  points  in  p2 
%  c  =  integration  constant 

% 

%  p2  =  integeral  of  pi 

%  jacob  =  partial  of  p2  with  respect  to  pi 
% 

% 

%  POLY  INT  integrates  a  given  polynomial  and  converts  the 
%  result  to  another  polynomial  of  size  n 


% 

nl  = 

nl<2) 

% 


size (pi) ; 
=  U  ; 


%  Error  checking 

% 

if  n  <  2 
n2  =  nl; 
else 

n2  **  n; 
end 
% 

if  nl  <  1 
p2  -  (]  ; 
return; 
end 


% 

%  calculate  the  integration  matrix 

% 

il  -  zeros (nl+1, nl) ; 


for  i  «•  1  :  nl 

jl  (i+1,  i)  =»  1  /  i; 
end 
% 

%  xx  is  (-1) * (n-1) 

% 

xx  «  ones(l,n2); 
for  i  -  2  :  n2 

xx(l,i)  =*  -  xx(l,i-l); 
end 


% 

%  calculate  the  indefinite  integral  of  the  polynomial 
pil  -  jl  *  pl; 


%  convert  to  a  polynomial  of  the  right  size 
(ip,  j2^  =  polypoly  (pil,  n2)  ; 


%  convert  to  a  definite  integral  by  adding  the  constant  of 
%  integration  and  subtracting  the  value  of  the  indefinite 
%  integral  at  x  =  -1 

% 


jacob  = 
p2  (1,1) 


j3  -  fxx 
-  p2(l,l) 


j3  ;  zeros (n2-l, nl) ] 
xx  *  j3  *  pl  +  c(l,l) 
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Normally,  a  user  would  call  w_int  to  integrate  a  waveform: 


function 

% 

%  W  INT 

% 


[w2  ,  jacob]  =  w  int (wl, n, si, c) 


%  Version  1.2  of  19  April 

% 

% 


1991 


% 

% 

% 

« 

% 

% 

% 

% 

% 

% 

% 

% 

% 

% 

% 

% 

% 

« 

% 


(C)  Copyright  1991  by  Norbert  H.  Doerry 
[w2,  jacob]  =  w_int  (wl, n,  si,  c) 

W  INT  integrates  a  waveform  and  returns  the  result  into  a  waveform  of 
“the  same  type  but  of  possible  different  length 

wl  =  input  waveform 

n  =  number  of  points  in  output  waveform 
si  =  type  of  waveform 
=  1  data  points 
=  2  fourier  series 
*=  3  legendre  series 
=  4  polynomial 
=  5  for  mat lab  polynomial 
=  6  for  chebyshev  series 

c  =  constant  of  integration 

w2  =  waveform  which  is  integral  of  wl 
jacob  “  jacobian  of  w2  with  respect  to  wl 


nl  ==  size(wl); 
nl<2)  -  []; 
if  n  <  1 
n2  “  nl; 
else 

n2  =  n; 
end 
% 

%  check  for  illegal  waveform  type 

% 

if  si  <  1  I  si  >  6 

'Illegal  waveform  type' 

Si 

return; 

end 


if  si  ===  1 

[w2  ,  jacob]  =  data_int (wl, n2, c)  ; 

% 

elseif  si  *==■  2 

[w2  ,  jacob]  «  four_int (wl,n2, c) ; 

% 

elseif  si  “=  3 


% 


w3,  j3 
w4,  n4 
[w2,  ]2 
jacob  = 


j2 


leg_poly ( wl , nl ) ; 
poly  int (w3, n2, c)  ; 

Soly  Ieg(w4,n2) ; 
j4  *  j3; 


elseif  si  =”  4 
[w2  ,  jacob] 

% 

elseif  si  =«  5 

j3 

w4,  l4 
|w2,  J2 
jacob  »• 

% 

elseif  si  =  6 
[w3,  j3 
fw4,  j4 
( w2 ,  j2 
jacob  =  j2 

% 

else 

' error' 

end 


poly_int (wl, n2, c) ; 


mplypoly (wl , nl ) ; 
poly_int (w3,n2,c) ; 
=  polymply (w4, n2) ; 
j2  5  5  j3; 


chebpoly (wl , nl ) ; 
poly  int (w3, n2. c) ; 
polycheb (w4, n2) ; 

*  j4  *  j3; 
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Notice  how  the  waveform  conversion  routines  are  used  to  implement  waveform 
operations  which  have  not  yet  been  defined  for  a  given  waveform  type. 
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Chapter  5  Simulation  Results 

As  a  demonstration  of  the  capabilities  of  WAVESIM,  the  results  of  three  simulations 
are  presented  here.  While  these  simulations  are  relatively  simple,  they  include  the  important 
features  of  more  difficult  simulations,  yet  are  not  so  complicated  as  to  be  unverifiable.  The 
first  simulation  of  a  simple  electical  circuit  containing  only  linear  devices  verifies  the  ability 
of  WAVESIM  to  construct  a  viable  system  and  limit  truncation  error  by  controlling  the 
waveform  interval  and  number  of  coefficients.  The  second  simulation  increases  the 
complexity  by  including  a  nonlinear  device  and  provides  a  good  test  of  the  Newton-Raphson 
solver.  The  third  and  final  simulation  demonstrates  the  use  of  a  continuation  parameter  to 
improve  the  region  of  convergence  of  the  simulation. 


- 148- 


5.1  Linear  Electrical  Circuit 


To  demonstrate  WAVESIM’s  ability  to  solve  linear  circuit  problems,  the  circuit 
shown  in  figure  5.1-1  was  simulated.  Initially,  both  capacitors  have  zero  charge  and  the 
inductor  currents  are  zero  as  well.  The  transients  of  the  capacitor  voltages  and  current  are 
shown  in  figure  5.1-2.  The  simulation  was  conducted  using  Legendre  Series  with  the  20 
second  simulation  time  split  up  among  23  intervals.  Eleven  intervals  were  rejected  due  to 
excessive  truncation  error. 


Figure  5.1-1:  Linear  Electrical  Circuit:  Schematic 


0  Rl  =  .l 

rVA- 


©Vs=l 


R2=l 

A/vV 


Ll  =  l 


Cl  =  l 


L2=l 


C2=l 


The  results  shown  in  figure  5.1-2  are  identical  (to  working  precision)  to  an  analytic 
solution  of  the  circuit. 

Figure  5.1-2:  Linear  Electrical  Circuit:  Simulation  Results 


rcrc.ni  using  LEGENDRE  SERIES  n  »  7 
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The  input  file  specifying  the  system  is  given  by: 

Input  File  for  Linear  Electrical  Circuit 

% 

%  rcrc.in 

% 

device  VDC_SOURCE  Vs 

TERMINAL  1  1 

TERMINAL  2  0 

PARAMETER  VS  1.0 
END 

% 

device  RESISTOR  Rl 
TERMINAL  1  1 

TERMINAL  2  2 

PARAMETER  R  0.1 

END 

% 

device  RESISTOR  R2 
TERMINAL  1  2 

TERMINAL  2  3 

PARAMETER  R  1.0 

END 

% 

device  INDUCTOR  Ll 

TERMINAL  1  2 

TERMINAL  2  0 

PARAMETER  L  1.0 

END 

« 

device  INDUCTOR  L2 

TERMINAL  1  3 

TERMINAL  2  0 

PARAMETER  L  1.0 

END 

% 

device  CAPACITOR  Cl 

TERMINAL  1  2 

TERMINAL  2  0 

PARAMETER  C  1.0 

END 

% 

device  CAPACITOR  C2 

TERMINAL  1  3 

TERMINAL  2  0 

PARAMETER  C  1.0 

END 


% 

default 

Gmin  0 
Rmin  0 
r import  NO 
check  both 
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error  eqn  kcl  5e-3 
error  eqn  pot  5e-3 
error  var  node  5e-3 
error  var  flow  5e-3 
error  mult  kcl  10.0 
error  mult  pot  10. 0 
error  mult  node  10. 0 
error  mult  flow  10.0 
max  count  10 
max  int  count  6 
alpha  ini t  1.0 
alpha  ire  init  .25 
alpha  inc  min  .05 
alpha  inc  max  .50 
diverge  start  3 
diverge  max  cnt  2 
diverge  error  mult  10.0 
waveform  content  max  .001 
waveform  content  nbr  2 
range  max  .005 
scale  potential  1.0 
scale  flow  1.0 

stype  3 
nbr  coef  7 
nbr  coef  min  6 
nbr  coef  max  14 
nbr  data  20 
END 

% 

% 

time 

dt  min  . 01 
dt  max  2 . 0 
dt  opt  .250 
dt  init  .5 
dt  ave  0 . 0 
start  0.0 
finish  20.0 
END 

% 

plot 

potential  Rl  2 
node  3 
flow  C2  1 
END 

Figure  5.1-3  shows  the  time  increment  and  number  of  coefficients  used  for  each  of  the 
intervals.  Once  the  transients  start  to  decay,  the  number  of  coefficients  are  decreased  to  the 
minimum  allowed. 
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Figure  5.1-3  Truncation  Error  Control 

Interval 

Ending  Time  (sec) 

Number  of 
Coefficients 

1 

0.25 

7 

2 

0.50 

7 

3 

0.75 

7 

4 

1.25 

7 

5 

2.25 

7 

6 

3.25 

6 

7 

4.25 

6 

8 

4.75 

6 

9 

5.25 

6 

10 

6.25 

6 

11 

7.25 

6 

12 

8.25 

6 

13 

8.75 

6 

14 

9.25 

6 

15 

10.25 

6 

16 

11.25 

6 

17 

12.25 

6 

18 

14.25 

6 

19 

15.25 

6 

20 

16.25 

6 

21 

17.25 

6 

22 

18.25 

6 

23 

20.00 

6 
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5.2  Nonlinear  Electrical  Circuit 


To  demonstrate  WAVESIM’s  ability  to  solve  nonlinear  circuit  problems,  the  circuit 
shown  in  figure  5.2-1  was  simulated.  Initially,  the  inductor  current  is  zero.  As  the  inductor 
current  builds  up,  its  voltage  is  clamped  by  the  diode  to  one  diode  drop  above  1  volt  and  its 
current  ramps  up  almost  linearly.  When  the  inductor  voltage  falls  far  enough  to  turn  the 
diode  off,  the  current  and  voltage  both  show  a  normal  exponential  transient  behavior. 
Figure  5.2-2  shows  the  inductor  voltage  and  current  as  a  function  of  time. 

Figure  5.2-1  Nonlinear  Electrical  Circuit:  Schematic 


The  results  shown  in  figure  5.2-2  were  calculated  using  Legendre  Series  over  seven 
time  intervals.  Five  additional  intervals  were  rejected  due  to  excessive  truncation  error. 
These  results  match  closely  an  analytic  solution  to  the  circuit. 
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Figure  5.2-2  Nonlinear  Electrical  Circuit:  Simulation  Results 


rd.no  using  LEGENDRE  SERIES  n  =  7 


The  input  file  specifying  the  system  is  given  by: 

Input  File  for  Nonlinear  Electrical  Circuit 


% 

%  rd.in 

% 

device  VDC_SOURCE  Vsl 
TERMINAL  1  1 

TERMINAL  2  0 

PARAMETER  VS  10.0 
END 

% 

device  RESISTOR  R1 

TERMINAL  1  1 

TERMINAL  2  2 

PARAMETER  R  1.0 
END 

% 

device  INDUCTOR  LI 

TERMINAL  1  2 

TERMINAL  2  0 

PARAMETER  L  1.0 
END 

% 

device  DIODE1  D1 

TERMINAL  1  2 

TERMINAL  2  3 

END 

% 
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device  VDC_SOURCE  Vs2 
TERMINAL  1  3 

TERMINAL  2  0 

PARAMETER  VS  1 . 0 
END 

% 

default 

Gmin  0 
Rmin  0 
rimport  NO 
check  both 

error  eqn  kcl  5e-3 
error  eqn  pot  5e-3 
error  var  node  5e-3 
error  var  flow  5e-3 
error  mult  kcl  10.0 
error  mult  pot  10.0 
error  mult  node  10.0 
error  mult  flow  10.0 
max  count  10 
max  int  count  6 
alpha  init  1 . 0 
alpha  inc  init  .25 
alpha  inc  min  .05 
alpha  inc  max  .50 
diverge  start  3 
diverge  max  cnt  2 
diverge  error  mult  10. 0 
waveform  content  max  . 001 
waveform  content  nbr  2 
range  max  .005 
scale  potential  1.0 
scale  flow  1.0 

wtype  3 
nbr  coef  7 
nbr  coef  min  7 
nbr  coef  max  10 
nbr  data  20 
END 


time 

dt  min  . 01 
dt  max  5 . 0 
dt  opt  .250 
dt  init  5 
dt  ave  . 01 
start  0.0 
finish  10.0 
END 


% 

plot 

potential  R1  2 
flow  LI  1 
END 
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Figure  5.2-3  Truncation  Error  Control 


Interval 

Ending  Time  (sec)  Number  of 

Coefficients 

5.3  Nonlinear  Mechanical  System 


To  demonstrate  the  ability  of  WA\AESIM  to  use  continuation  parameters  in  simulating 
nonlinear  mechanical  systems,  a  mechanical  power  train  was  modelled.  The  acceleration 
characteristic  of  a  ship  was  determined  for  a  propeller  rotating  at  a  constant  speed.  Figure 
5.3-1  shows  a  schematic  diagram  of  the  system. 

Figure  5.3-1  Nonlinear  Mechanical  System :  Schematic 


The  propeller  model  is  described  in  Appendix  F-8  while  the  ship  dynamics  model  is 
described  in  Appendix  F-9.  Figure  5.3-2  shows  the  parametric  curves  used  for  CT ()  and 
CqQ.  This  data  is  for  a  three  bladed  propeller  with  an  expanded  area  ratio  of  .5  and  an  H/D 
ratio  of  .6  [81]. 

Figure  5.3-3  shows  the  Residual  drag  coefficient  used  in  the  ship  dynamics  model. 
This  data  is  from  the  Taylor  Standard  Series  for  a  hull  with  beam  to  draft  ratio  of  3.0, 
Prismatic  Coefficient  (Cp)  of  .68,  and  Volumetric  coefficient  of  0.002.  The  Frictional  Drag 
Coeffient  was  calculated  using  the  standard  ITTC  Line: 

c/m-  °7?  , 

A  Gog10(/L)-2)2 
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Figure  5.3-2  Nonlinear  Mechanical  System:  Propeller  Characteristics 


3  Blade  Propeller  Curves :  EAR  *  .5  :  H/D  =  j6 


Figure  5.3-3  Nonlinear  Mechanical  System:  Drag  Coefficient 


*10-J  Residual  Drag  Coefficient  vs  Fr 
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The  input  file  specifying  the  system  is  given  by: 

Input  File  for  Nonlinear  Mechanical  System 


% 

%  shipmol . in 

% 

%  Model  of  a  prime  mover  attached  to  prop  going  to  the  sea 

% 

device  NODE_REF  GT1 
TERMINAL  1  1 
PARAMETER  Vref  5.0 
END 

% 

device  PROP1  prop 
TERMINAL  SHAFT  1 
TERMINAL  WATER  2 
PARAMETER  D  10.0 
PARAMETER  w  0.0 

end 

% 

%  parameters  are  rough  ones  from  Sue  B  Gail 

% 

device  SHIPDYN1  ship 
TERMINAL  WATER  2 
PARAMETER  L  100 
PARAMETER  A  3300 
PARAMETER  M  15000000 
PARAMETER  Madd  1.05 
PARAMETER  Ca  0.0004 
STATE  Us  0 

end 

% 

Node  1 

SCALE  POTENTIAL  1 
SCALE  FLOW  le-4 

NAME  Propeller_Shaft 
Gmin  1 
END 

Node  2 

SCALE  POTENTIAL  1 
SCALE  FLOW  le-4 

NAME  Hydrodynamic_U_force 
END 


% 

default 

Gmin  0 
Rmin  0 
r import  NO 
check  eqn 

error  eqn  kcl  le-2 
error  eqn  pot  le-2 
error  var  node  le-2 
error  var  flow  le-2 
error  mult  kcl  10.0 
error  mult  pot  10.0 
error  mult  node  10.0 
error  mult  flow  10.0 
max  count  10 
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max  int  count  6 

alpha  init  0.5 

alpha  inc  init  . 25 

alpha  inc  min  .05 

alpha  inc  max  .50 

diverge  start  3 

diverge  max  cnt  2 

diverge  error  mult  10.0 

waveform  content  max  .005 

waveform  content  nbr  2 

range  max  .005 

scale  potential  1.0 

scale  flow  1.0 

stype  3 

nbr  coef  7 

nbr  coef  min  6 

nbr  coef  max  10 

nbr  data  20 

END 

% 

time 

dt  min  .25 
dt  max  5 . 0 
dt  opt  1 . 0 
dt  init  2 . 0 
dt  ave  0 . 0 
start  0.0 
finish  7.25 
END 

% 

plot 

%  node  1  converted  to  RPM 

%  node  2  converted  to  Knots  (more  or  less) 

% 

node  1  9.5492966 

node  2  1.8 

flow  ship  WATER  le-5 
flow  prop  SHAFT  le-5 
END 

The  results  of  the  simulation  using  Legendre  Series  are  shown  in  figure  5.3-4.  The 
simulation  was  broken  into  24  intervals  shown  in  figure  5.3-5.  An  additional  25  intervals 
were  rejected  due  to  excessive  truncation  error.  For  each  iteration,  the  continuation 
parameter  was  initially  set  to  0.5.  This  value  helped  assure  the  initial  value  of  0  was  within 
the  convergence  region  of  the  nonlinear  blocks.  While  0.5  was  suitable  for  most  iterations, 
several  required  the  continuation  parameter  be  decremented  further  to  achieve  convergence. 
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Figure  5.3-4  Nonlinear  Mechanical  System:  Simulation  Results 


shipmo2  jd  using  LEGENDRE  SERIES  n  =  7 


As  expected,  the  force  on  the  propeller  is  greatest  during  the  acceleration  of  the  ship. 
As  the  ship  accelerates,  the  increased  forward  velocity  on  the  ship  results  in  smaller  torques 
and  forces.  In  reality  it  is  doubtful  the  motor  would  be  capable  of  maintaining  a  constant 
RPM  during  the  acceleration  phase. 
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Figure  5 3-5  Truncation  Error  Control 

Interval 

Ending  Time  (sec)  Number  of 

Coefficients 

1 

1 

7 

2 

1.5 

8 

3 

1.75 

10 

4 

2.25 

10 

5 

2.5 

10 

6 

2.75 

10 

7 

3.0 

10 

8 

3.25 

10 

9 

3.5 

10 

10 

3.75 

10 

11 

4.0 

10 

12 

4.25 

10 

13 

4.5 

10 

14 

4.75 

10 

15 

5.0 

10 

16 

5.25 

10 

17 

5.5 

10 

18 

5.75 

10 

19 

6.0 

10 

20 

6.25 

10 

21 

6.5 

10 

22 

6.75 

10 

23 

7 

10 

24 

7.25 

10 
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Chapter  6  Conclusions 

In  its  present  form,  WAVESIM  is  ideally  suited  for  testing  numerical  algorithms. 
While  it  is  capable  of  simulating  large  systems,  the  interpretive  nature  of  MATLAB  is  not 
numerically  efficient  enough  for  serious  simulations.  Careful  development  of  a  simulation 
environment  based  on  the  techniques  explored  in  WAVESIM  should  prove  effective  in 
solving  tighdy  coupled  multirate  systems  of  lumped  parameter  models. 

The  simulation  environment  described  in  this  thesis  should  be  considered  a  framework 
for  future  developments.  Many  improvements  are  possible  and  desirable.  In  particular,  the 
following  areas  need  further  attention: 

Truncation  Error  Control 

The  present  method  for  controlling  truncation  error  is  heuristic  and  should  be 
examined  for  improvement.  Truncation  Error  propagation  should  be  examined  and 
given  a  theoretical  basis. 

Discontinuity  Time  Prediction 

The  accuracy  of  the  methods  used  in  WAVESIM  depend  partly  on  the  ability  to 
predict  discontinuities  and  force  them  to  occur  on  time  interval  boundaries.  The 
methods  used  in  current  models  are  crude  and  should  be  replaced  with  more  robust  and 
accurate  methods. 

Stability  Analysis 

WAVESIM  presendy  does  not  perform  any  stability  analysis.  Since  WAVESIM 
abandons  the  standard  state  space  representation  of  the  system,  determining  the 
eigenstructure  of  the  system  is  not  easy  A  stability  measure  based  on  the 
characteristics  of  individual  devices  would  fit  well  with  the  structure  of  WAVESIM 
and  would  be  quite  useful  in  the  design  of  distributed  controls. 

Smoothing  Operation 

The  smoothing  operator  for  removing  the  effects  of  high  frequency 
discontinuities  needs  to  be  examined  to  improve  its  efficiency.  How  long  to  make  the 
smoothing  interval  is  a  question  which  has  not  been  satisfactorily  answered. 

Partitioning  and  Relaxation 
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The  approach  WAVESEM  uses  for  developing  the  set  of  system  equations  is 
ideally  suited  for  use  with  relaxation  methods  if  the  system  is  weakly  coupled.  An 
extension  to  the  structural  Jacobian  to  include  matrix  norms  would  greatly  simply  the 
task  of  partitioning  the  system  into  a  set  of  weakly  coupled  blocks  which  internally  are 
strongly  coupled.  Each  individual  block  would  be  solved  using  Newton-Raphson  with 
the  system  solved  using  a  relaxation  technique.  Unfortunately,  the  process  of 
constructing  a  system  matrix  of  norms  from  device  matrix  norms  is  presently  not 
possible  because  arithmetic  operators  for  matrix  norms  have  not  been  identified. 

Overall,  WAVESIM  has  been  very  successful  in  developing  the  algorithms  for  building 
systems  in  terms  of  device  functions,  treating  waveforms  as  an  abstract  data  type,  and 
employing  the  structural  Jacobian  matrix  to  reduce  the  system  into  a  sequence  of  smaller 
blocks.  Much  work  remains,  but  the  foundation  of  a  waveform  based  simulator  capable  of 
handling  tightly  coupled  multirate  simulation  problems  is  contained  within  WAVESIM. 
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Appendix  A:  Glossary 


Block 

Continuation 

Parameter 

Device 

device . def 

Device  Jacobian 

Device  Structural 
Jacobian  Matrix 

Export  Variable 


A  subset  of  a  system’s  equations  and  variables  which  must  be  solved 
simultaneously.  Blocks  are  organized  into  a  sequence  where 
variables  determined  in  a  previous  block  may  be  used  in  following 
blocks. 

A  technique  to  enlarge  the  convergence  region  of  a  nonlinear  system 
by  using  the  solution  to  a  linear  system  as  the  initial  guess  for  the 
solution  of  another  system  which  is  a  combination  of  the  linear  and 
nonlinear  systems.  The  process  is  repeated  with  each  iteration 
increasing  the  nonlinear  portion  until  the  solution  to  the  nonlinear 
system  is  determined.  The  continuation  parameter  determines  the 
relative  proportion  of  the  nonlinear  system;  0  for  the  linear  system 
and  1  for  the  desired  nonlinear  system. 

A  device  is  a  mathematical  model  of  a  physical  piece  of  equipment 
comprising  a  system.  Devices  interact  with  one  another  through 
interface  variables  which  are  associated  with  other  device  interface 
variables  through  terminals  connected  at  nodes.  The  equations 
describing  a  given  device  type  are  specified  in  the  device  definition. 
A  given  instance  of  a  device  also  has  associated  parameters  and 
nodal  connections. 

A  file  for  describing  a  device  definition.  Each  device  type  has  an 
entry  describing  the  device  type  name,  terminals,  states,  parameters, 
structural  Jacobian,  and  MATLAB  M-File  containing  the 
constitutive  equations. 

A  matrix  whose  elements  are  the  partial  derivatives  of  the  export 
variables  of  a  device  with  respect  to  the  device  import  variables. 

A  matrix  describing  the  dependence  of  a  device’s  export  variable 
with  respect  to  the  import  variables.  The  dependence  is  specified  by 
a  matrix  whose  elements  are  a  code  indicating  if  the  dependence  is 
zero,  identity,  diagonal,  linear,  or  nonlinear. 

An  interface  variable  (either  a  potential  or  flow  variable)  of  a  device 
which  is  explicitly  defined  by  the  device  constitutive  equations.  A 
device  takes  import  variables  as  input  and  produces  export  variables. 
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Flow  Variable 


An  interface  variable  (either  an  export  or  import  variable)  associated 
with  a  normal  terminal  of  a  device  which  corresponds  to  a  quantity 
satisfying  Kirchhoff  s  Current  Law  at  nodes.  Examples  of  flow 
variables  are  currents,  forces,  and  torques. 

Gmkt  A  modification  to  the  KCL  equations  at  a  node  corresponding  to  the 

insertion  of  a  conductance  to  the  0  potential.  Used  to  prevent 
singular  systems. 

Import  Variable  An  interface  variable  (either  a  potential  or  flow  variable)  of  a  device 

which  is  implicitly  defined  by  the  device  constitutive  equations.  A 
device  takes  import  variables  as  input  and  produces  export  variables. 

Information  A  terminal  of  a  device  having  only  a  potential  associated  with  it. 

Terminal  Used  to  convey  energyless  information  between  devices. 

Interface  Variable  Variables  through  which  devices  communicate  energy  and 

information  transfer  to  other  devices.  Interface  variables  are 
associated  with  terminals,  can  be  classified  as  either  flow  or 
potential  variables  and  can  be  classified  as  either  import  or  export 
variables. 

KCL  KirchhofFs  Current  Law  which  states  the  sum  of  the  flow  variables 

attached  to  a  node  is  zero. 

KCL  Equation  Equates  the  sum  of  the  flow  variables  attached  to  a  node  to  zero. 

Group  If  a  subset  of  a  device’s  flow  variables  add  to  zero  by  definition, 
then  the  elements  of  such  a  subset  have  a  device-unique  nonzero 
group  number.  Flow  variables  which  do  not  belong  to  such  a  subset 
have  a  0  KCL  Group  Number. 

KCL  Group  Numbers  are  used  to  determine  possible  singular 
systems  due  to  linear  dependence  of  system  KCL  equations. 

MATLAB  M-File  Text  files  of  MATLAB  commands  for  creating  new  MATLAB 

functions  or  executing  scripts. 

Newton-Raphson  An  iterative  technique  for  solving  systems  of  nonlinear  equations 

Method  which  uses  the  Jacobian  Matrix  to  generate  corrections  to  the  system 

variables. 


KCL 

Number 
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Structural  Jacobian 
Code 

Subsystem 

System 

System  Jacobian 

System  Structural 
Jacobian  Matrix 

System  Variable 
Terminal 

Waveform 

Waveform  Content 


A  code  indicating  the  nature  of  an  element  of  a  Jacobian  matrix: 

0  Zero  Matrix 
I  Identity  Matrix 
D  Diagonal  Matrix 
L  Linear  Matrix 
A  Type  A  nonlinear  Matrix 
N  Nonlinear  Matrix 
U  Unknown 

A  subset  of  the  devices  of  a  system  which  are  grouped  together  and 
solved  independently  of  other  devices  and  subsystems.  Subsystems 
have  not  been  implemented  in  WAVESIM. 

A  group  of  devices  and  subsystems  and  the  nodes  interconnected 
them. 

A  matrix  containing  the  partial  derivatives  of  the  system  equations 
with  respect  to  the  system  variables. 

A  matrix  describing  the  dependence  of  a  system’s  equations  with 
respect  to  the  system  variables.  The  dependence  is  specified  by  a 
matrix  whose  elements  are  a  code  indicating  if  the  dependence  is 
zero,  identity,  diagonal,  linear,  or  nonlinear. 

The  set  of  system  variables  is  composed  of  all  the  node  potentials 
and  all  the  device  import  flow  variables. 

A  modelling  analogy  to  a  physical  attachment  point  on  a  device. 
Normal  terminals  have  an  associated  flow  and  potential  variable  and 
are  used  to  model  the  transfer  of  energy  into  and  out  of  a  device. 
Information  terminals  have  only  a  potential  variable  and  are  used  to 
convey  information  between  devices. 

A  representation  of  a  variable  over  a  given  rime  interval  consisting 
of  a  vector  of  coefficients  and  a  waveform  type  indicator  for 
specifying  how  the  coefficients  should  be  interpreted.  Common 
waveform  types  are  Legendre  Series,  Chebyshev  Series, 
Polynomials  and  Data  Points. 

The  magnitude  of  a  coefficient  of  a  waveform  divided  by  the  square 
root  of  the  sum  of  all  the  waveform  coefficients.  The  Waveform 
Contents  of  the  higher  order  coefficients  are  used  to  determine  if  the 
truncation  error  is  negligible. 
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Waveform  Type  An  indicator  specifying  how  the  coefficients  of  the  waveform  vector 
Indicator  should  be  interpreted.  Common  waveform  types  are  Legendre 

Series,  Chebyshev  Series,  Polynomials  and  Data  Points. 

WAVESIM  A  numerical  algorithm  development  program  incorporating  the 

systematic  treatment  of  waveforms  as  a  data  type,  the  terminal 
description  of  devices,  and  the  use  of  structural  Jacobians  in  system 
reduction. 
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Appendix  B:  Continuation  Parameter  Pitfalls 

If  used  properly,  continuation  parameters  can  help  enlargen  the  region  of  convergence 
of  an  iterative  scheme.  This  section  will  show  how  continuation  parameters  can  fail  due  to 
bifurcations  of  solutions. 

Take  for  example,  the  following  system  of  two  equations  and  two  unknowns 
F(xo’)  =  0: 

F,(*,y)  =  y-(*3-*)=o 
F2(jc,y)  =  y  -  (Mx  +B)  =  0 

Initially,  set  M  =  0  and  B  =  1.875.  From  the  following  figure,  it  is  obvious  the  solution 
is  the  intersection  of  the  two  curves  and  falls  at  the  point  (1.5,1.875). 

Figure  B-l:  Solution  toy  =  x3  -  x  andy  =  1.875 


To  solve  this  system  with  a  continuation  parameter,  we  create  a  new  function  H(x^y, a) 
which  is  formed  by  combining  F(x,y)  with  a  linear  system  G(xy): 

Gi(x,y)  =  y-(mx+b)  =  0 
G2(x,y)  =  y -(Mx+B)  =  0 
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H{x,  y,  a)  =  a F(x,  v)  +  (1  -  a )G(x,  y)  =  0 


The  modeller  now  has  the  choice  of  selecting  m  and  b.  A  natural  choice  would  be  a 
linearization  about  a  given  point.  If  we  linearize  about  x  =  0,  the  values  are  m  =  -1  and  b  =  0. 
The  following  figure  shows  the  results  of  this  selection: 

Figure  B-2:  Continuation  Method  for  m=-l  b= 0  M- 0  B=1.875 
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a 

x  Root  Locus  Points 

y  =  a(.x3-;t)  +  (l  —  cx)(— jc) 

y  =  1.875 

0 

-1.8750 

0.0100 

10.8310 

-8.8820 

-1.9490 

0.0200 

7.8686 

-5.8222 

-2.0464 

0.0400 

5.7569 

-3.2569 

-2.5000 

0.0421 

5.6274 

-2.8637 

-2.7637 

0.0422 

5.6214 

-2.8107 -0.06l3i 

-2.8107 +  0.0613i 

0.0600 

4.8125 

-2.4063  -  0.8387i 

-2.4063  +  0.8387i 

0.1000 

3.8553 

-1.9277-  1.071 2i 

-1.9277+  1.071 2i 

0.2000 

2.8743 

-1.4372-  1.0937i 

-1.4372+  1.0937i 

0.4000 

2.1609 

-1.0804-  l.OOlOi 

-1.0804+  1.001  Oi 

0.5000 

1.9746 

-0.9873  -  0.9614i 

-0.9873  +  0.9614i 

0.7000 

1.7263 

-0.8632 -0.8981i 

-0.8632  +  0.89811 

1.0000 

-0.7500  -  0.8292i 

-0.7500  +  0.8292i 

Note  the  solution  for  a  =  0  is  (-1.875,1.875)  which  is  not  very  close  to  the  desired 
solution  for  a  =  1.  Furthermore,  as  a  increases  slightly,  it  actually  becomes  slightly  more 
negative  until  the  nonlinear  curve  no  longer  intersects  the  linear  equation  in  the  left  hand 
plane.  At  this  point,  the  solution  has  a  discontinuity  and  jumps  into  the  right  hand  plane  with 
a  value  for  x  much  larger  than  the  solution.  The  root  locus  for  x  as  a  goes  from  0  to  1  clearly 
shows  this.  Hence  for  this  selection  of  m  and  b,  the  use  of  the  continuation  parameter  makes 
the  job  of  solving  the  system  tougher  instead  of  easier. 

If  we  choose  different  values  for  m  and  b,  the  situ'.ation  may  change.  Say  for  example, 
we  set  m  =  1  and  b  -  0.  This  selection  appears  to  work  well  as  can  be  seen  with  the 
following  Figure: 
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a 

x  Root  Locus  Points  1 

y  =  o(x3-a:)  +  (1  -a)x 

y  =  1.875 

0 

1.8750 

0.0400 

1.7891 

-0.8945  -  5.0399i 

-0.8945  +  5.0399i 

0.2000 

1.6440 

-0.8220  -  2.242 li 

-0.8220  +  2.242 li 

0.5000 

1.5536 

-0.7768  -  1.3455i 

-0.7768  +  1.3455i 

1.0000 

1.5000 

-0.7500  -  0.8292i 

-0.7500  +  0.8292i 

The  solution  for  a  =  0  is  close  to  the  solution  and  as  a  increases,  it  rapidly  converges 
on  the  desired  solution  (1.5,1.875).  We  should  not  rejoice  however,  because  even  this 
selection  can  fail  for  other  choices  for  M  and  B.  For  example,  if  Af  =  2-5  and  B  =  -3,  the 
following  figure  demonstrates  a  discontinuity  in  the  solution  path: 

Figure  B-4:  Continuation  Method  for  m- 1  6=0  M=2.5  B=- 3 
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ROOT  LOCUS  for  y  =  2Jx-3  y  =  «(x*3-x)  +  (»-lXx) 


x  Root  Locus  Points 

y  =  a(r3-;t)  +  (l  -a)x 
y  =  2.5y  -  3 


0.0100 

-13.2173 

11.1887 

2.0286 

0.0200 

-9.6223 

7.5604 

2.0619 

0.0400 

-7.0779 

4.9274 

2.1505 

0.0735 

-5.4659 

2.7706 

2.6953 

0.0736 

-5.4628 

2.7314  -0.0326i 

2.7314 +  0.0326i 

0.0800 

-5.2778 

2.6389  -0.3761i 

2.6389  +  0.3761i 

0.1000 

-4.8192 

2.4096 -0.647H 

2.4096  +  0.647  li 

0.3000 

-3.1844 

1.5922 -0.7780i 

1.5922  +  0.7780i 

0.5000 

-2.6891 

1.3445  -0.6507i 

1.3445 +  0.6507i 

1.0000 

-2.2047 

1.1024  -0.3815i 

1.1024  + 0.38 15i 
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The  bottom  line  is  that  it  may  not  be  possible  to  develop  a  transformation  function 
whose  solution  vector  is  always  continuous.  Any  information  known  as  to  the  region  where 
the  probable  operating  point  lies  should  be  used  in  directing  the  solution  to  that  region.  For 
this  example,  if  x  is  known  to  be  constrained  to  the  interval  [-5  5]  and  M  is  known  to  be  less 
than  17.75  (.75»52  -  1  is  the  slope  of  the  line  tangent  toy  =  x3  -  x  and  passing  through  (5,120) 
)  then  y  is  also  constrained  to  the  interval  [-120  120].  If  we  use  as  our  linearizing  function 
the  line  connecting  (-5,-120)  and  (5,120)  it  is  clear  the  root  locus  will  also  remain  within  the 
constraints  for  any  value  of  M  or  B  meeting  the  constraints  at  a  =  1: 

y  =  a(;t3  -  x)  +  (1  -  a)24jc 

Figure  B-5:  Continuatin  method  for  m= 24  b= 0  M-2.5  B=- 3 
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For  this  example  it  is  actually  quit  easy  to  determine  if  a  bifurcation  will  occur.  At  a 
bifurcation,  the  x  root  locus  points  satisfy  the  following  relationship: 

(x-cf(x-d)  =  0 

x3  +  (-d-2c)x2  +  (c2  +  2cd)x  +  (-c2d) 

where  c  is  the  multiple  root  whose  paths  will  deviate  from  the  real  x-axis  and  d  is  the 
root  staying  on  the  x-axis.  Now  the  actual  equation  defining  the  roots  is  given  by: 

cur3  +  ((1  - a)m  - a-M)x  +(1  -a)b  -B  =  0 

Equating  terms  we  get: 

-d-2c  =0 

c2  +  2cd  =  — ((1  -a)m  -a-M) 
oc 

- c2d=-((l-a)b-B ) 

OC 

solving  this  system  for  c,  d,  and  a,  we  get: 

d  = -2c 


f(l-« )b-B^ 


V  2a  J 


(1  -  a )m  -a-M  +  3( 


(1-a )b-B 
2a 


=  0 


If  one  of  the  solutions  for  a  is  a  real  number  in  the  interval  [0,1],  then  there  will  be  a 
bifurcation  and  possibly  a  discontinuity  in  the  path.  If  two  of  the  roots  approach  from  +°° 
and  -<*>  along  the  real  axis  and  a  solution  for  a  exists  in  the  interval  [0,1],  then  there  will 
definitely  be  a  discontinuity  in  the  solution  path.  If  two  roots  appraoch  from  off  the  real  axis, 
combine  at  the  bifurcation  point,  then  travel  in  the  +x  and  -x  directions,  there  will  be  three 
real  solutions  for  x  and  the  solution  path  will  converge  onto  one  of  them.  If  there  is  no  real 
solution  for  a  in  the  interval  [0,1],  then  there  will  be  no  bifurcation,  no  discontinuity  in  the 
solution  path  and  the  solution  will  be  unique. 
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Appendix  C:  Load  Flow  Example 

The  method  for  building  systems  can  be  applied  to  static  simulations  for  determining 
equilibrium  points  of  systems.  The  traditional  load  flow  is  representative  of  this  type  of 
problem.  Figure  C-l  shows  a  three  bus  load  flow  example  consisting  of  four  device  types: 
PV  Generator,  VD  Generator  (Slack  Bus),  PQ  Load,  and  a  transmission  line. 

Figure  C-l:  3  Bus  Load  Flow  Example 
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C-l:  Device  Definitions 
C-l.l:  PV  Generator 


Interface  Variables 

Terminal  Potential  Variable  Flow  Variable 


VQ 

DP 


V  (export) 
D  (import) 


Q  (import) 
P  (export) 


The  import  X^p  and  export  Xtx?  vectors  are  defined  by: 


imp 


*«r  = 


JQ 1 

[d\ 

■[3 


(KCL  Group)  Type 

(0)  Normal 
(0)  Normal 


Parameters 

PG  Scheduled  Generator  Power 

VG  Scheduled  Generator  Vo*  ge 

Equations 


V=VC 
P  =  -PG 


Device  Structural  Jacobian 

The  device  structural  jacobian  is  given  by: 


Device  Jacobian 

The  device  jacobian  is  given  by: 


C-1.2:  VD  Generator  (Slack  Bus) 
Interface  Variables 


Terminal  Potential  Variable  Flow  Variable 

VQ  V  (export)  Q  (import) 

DP  D  (export)  P  (import) 

The  import  and  export  Xcx?  vectors  are  defined  by: 


(KCL  Group)  Type 

(0)  Normal 
(0)  Normal 


Parameters 

VG  Scheduled  Generator  Voltage 

Dg  Scheduled  Generator  Angle 

Equations 


V=VC 
Z)  =  DC 


Device  Structural  Jacobian 

The  device  structural  jacobian  is  given  by: 


Device  Jacobian 


The  device  jacobian  is  given  by: 


3 d  * 


O' 

0 
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C-1.3:  PQ  Load 
Interface  Variables 


Terminal  Potential  Variable  Flow  Variable 


VQ  V  (import)  Q  (export) 

DP  D  (import)  P  (export) 


The  import  X*,  and  export  X ^  vectors  are  defined  by: 

*--[»] 


(KCL  Group)  Type 

(0)  Normal 
(0)  Normal 


Parameters 

PL  Scheduled  Load  Real  Power 

Ql  Scheduled  Load  Reactive  Power 

Equations 


P  =  PL 
Q  =  Ql 


Device  Structural  Jacobian 

The  device  structural  jacobian  is  given  by: 


'  DS 


■[::] 


Device  Jacobian 

The  device  jacobian  is  given  by: 


,  -[°  °1 
c  L°  °J 
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C-1.4:  Transmission  Line 


Interface  Variables 


Terminal 


VQ1 

DPI 

VQ2 

DP2 

The  import 


Potential  Variable 

Vj  (import) 

D,  (import) 

V 2  (import) 

D2  (import) 


Flow  Variable 

Q,  (export) 

Pt  (export) 

Q2  (export) 

P2  (export) 

vectors  are  defined  by: 


re.l 


and  export  Xexp 


(KCL  Group)  Type 

(0)  Normal 
(0)  Normal 

(0)  Normal 
(0)  Normal 


Parameters 

R  Transmission  Line  resistance 

X  Transmission  Line  reactance 

Equations 

Obtain  Y : 

R2+X2 

r2+x2 


y  =  ^a2+b2 

Dr  =  atan2  (5 ,  A ) 
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Calculate  Side  one  current 


/w  =  V, F  cos (D,  +Dr)  -  V2Y  cos (D2+Dy) 
Iu  =  VJ  sin  (£>,  +Dy)  -  V2y  sin(£>2  +£>y) 

Calculate  Side  two  current 


Calculate  real  and  imaginary  parts  of  the  voltages 

Vut  =  Vlcos(Dl) 
Vu  =  Vt  sin(£>,) 

Vm  =  V2cos(D2) 
V2I  =  V2sm(D2) 

Calculate  the  export  variables  (Powers) 

2i  = 

^2  =  ^ZjJ 2X  ”**  Vyl V 
Qz  ~  ~^ZJt^2J  +  ^ZJ^ZK 

Device  Structural  Jacobian 


'N 

N 

N 

N' 

N 

N 

N 

N 

N 

N 

N 

N 

N 

N 

N 

N 
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Device  Jacobian 


Calculate  the  Partial  derivatives  of  the  voltages  with  respect  to  the  import  variables: 


dXm 


=  [cos(D,)  -  Vx  sin(Z),)  0  0] 


BVy 

ax 


=  [sin(Z),)  V,  cos(D,)  0  0] 


imp 


dv. 


2R 


ax. 


=  [0  0  cos(D2)  -  V2  sin(Z)2)] 


dVv 

ax, 


=  [0  0  sin(£>2)  V2  cosfDj)] 


imp 


Calculate  the  partials  of  die  currents  with  respect  to  the  import  variables: 

-^-  =  [Xcos(£>,+£>y)  -  YVX  sin(Dl  +DY)  -Ycos(D2+Dr)  YV2s'm{D2+ Dr)] 

ax^ 

a/ 

— =  [X  sin(D,  +DY)  YVxcos{Dx  +Dr)  -Ysin(D2  +  Dr)  -YV2cos(D2  +  Dy)} 

ax*. 


a/yf 

a/w 

1 

ax^ 

a/a 

c 

ax^' 

BXmp 
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Calculate  the  jacobian  matrix 


r*vi 


dVu 


dim 

dX~ 


JD  = 


/« 

V* 

0 

0 

0 

0  ' 

dlv 

Im 

Iu 

V* 

Vu 

0 

0 

u 

0 

dXmp 

0 

0 

0 

0 

~  I 21 

1 21: 

V* 

-V* 

dvz: 

0 

0 

0 

0 

h it 

I'd 

V* 

V2J  . 

dXimp 

dV» 

dXmp 

dltf 


dXmp 

dlv 
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C-2:  Network  Description 

Figure  C-2-1  details  the  device  interconnections  of  the  3  Bus  system  shown  in  Figure 

C-l. 

Figure  C-2-1:  3  Bus  Loadflow  Block  Diagram 
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C-2.1:  Variable  Labeling  Convention 

For  this  example,  the  following  convention  will  be  used  for  labeling  variables  and 
functions: 

Device  Terminal  Variables: 

aa  Device  Name 

bb  Variable  Name 

c  n  =  normal  terminal 

i  =  information  terminal 

d  i  =  import  variable 

e  =  export  variable 

/  p  =  potential  variable 

/=  flow  variable 

Device  import  variable  vector  , 
aa  Device  name 

Device  export  variable  defining  function  xaaJ>b  c^=faa  bi  c^(xtu,J) 

aa  Device  Name 

bb  Variable  Name 

c  n  -  normal  terminal 

i  =  information  terminal 

d  e-  export  variable 

/  p  -  potential  variable 

f  =  flow  variable 

Device  Jacobian 

Device  Jacobian  Element  J„ 

aa  Device  Name 

bb  Export  Variable  Name 

gg  Import  Variable  Name 

System  Variables:  Node  Potentials  V. 

n  Node  Serial  Number 

System  Variables:  Flow  Variables  /„  ^ 

aa  Device  Name 

bb  Variable  Name 
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System  Equation:  KCL  g„() 

n  Serial  number  of  node  KCL  is  applied  to 

System  Equation:  Potentials  g„  „  UQ 

ft  Serial  number  of  node 

aa  Device  Name 

bb  Export  Potential  Variable  Name 

System  Jacobian  Element:  KCL  vs  Node  Potential  Jm  m  m 
System  Jacobian  Element:  KCL  vs  Import  Flow  JOI ,  „  ** 

System  Jacobian  Element:  Potential  Eqn  vs  Node  Potential  J,yi  „  u_m 
System  Jacobian  Element:  Potential  Eqn  vs  Import  flow  J ,yi  cc  Jd  at,  bb 

n  Serial  number  of  KCL  node 

m  Serial  number  of  Node  Potential 
aa  Flow  Variable  Device  Name 

bb  Flow  Variable  Device  Variable  Name 

cc  Potential  Equation  Potential  Device  Name 
dd  Potential  Equation  Potential  Variable  Name 
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C-2.2:  Network  Specification 


Now  that  the  variable  labeling  convention  has  been  addressed,  it  is  time  to  define  the 
devices  and  the  network  interconnecting  them. 

PD  Generator  G1 


Potential  Variable  Flow  Variable 

XGl_V_mep  XG1  Q  nif 

XGl  J>_ntp  XGJ_P_nif 

VG  1.0  PU 

Dc  0.0  RAD 

Import  Vector: 

\XGl_Q_mf 


Igi_q 

Igij> 


Terminal 

VQ 

DP 

Parameter 


Node 

1 

4 


PV  Generator  G2 

Terminal  Potential  Variable  Flow  Variable  Node 

VQ  ’-~P  XG2jHjdf  \ 

DP  XG2  _P_mip  XG2JPjuf  ^ 

Parameters 

PG  0.5  PU 

VG  1.05  PU 

Import  Vector: 


XG2J 


XG2_Q_nif 
XG2  J>_nip 
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PQ  Load  L3 


Terminal 

VQ 

DP 

Parameters 

PL  0.6 

Ql  0.3 

Import  Vector: 


Potential  Variable 

XL3_V_*ip 

XU_D_mip 


Flow  Variable 

XU_Q-<“t 

XL3_r_mtJ 


PU 

PU 


XUJ  — 


XU_Vjiip 
XL3  J)_nip 


Vi 

V6 


Transmission  Line  T12 


Terminal 

VQ1 

DPI 

VQ2 

DP2 

Parameters 

R  0.15 

X  0.60 

Import  Vector: 


Potential  Variable 

XTl2Vljup 
XT12  J}l_nip 

XT12_V2_nip 

XT12_D2_nip 


XTI2J 


Flow  Variable 

XT12  _Ql_mef 
XT12JN_mef 

XT12_Q2_*tf 

XT12_P2_n*f 


XT12_V1  _rup 

'Vi 

XT12  J)l_nip 

V 4 

XTt2_V2_nip 

XT12J)2_mp_ 

^5 

PU 

PU 


Node 

3 

6 


Node 

1 

4 

2 

5 
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Transmission  Line  T13 


Terminal  Potential  Variable  Flow  Variable 


VQ1 

DPI 

VQ2 

DP2 

Parameters 


XTi3_VI_mip 

XT13_QI_nef 

XT13J)l_nip 

XTJ3J>J_mef 

XTl3\2juf 

XT13_Q2_*ef 

Xni  JD2_nip 

XT13_P2_mef 

R  0.05  PU 

X  0.20  PU 


Import  Vector: 


X. T13_Vl_rup 

~v; 

XT13_D1  _niP 

vA 

XT13_V2_rup 

v. 

_XT13_D2_nip_ 

i£: 

Transmission  Line  T23 


Terminal 

VQ1 

DPI 

VQ2 

DP2 

Parameters 

R  0.10 

X  0.40 

Import  Vector: 


Potential  Variable 

XT23Vlnip 

XT23J)l_mip 

XT23_V2_nip 
XT23  J)2jtip 


XT23_i 


Flow  Variable 

XT23_£lj>*f 

XT23_Pljnef 

XT23jQ2_*€f 

XT2J_P2_nef 


XT23  _V1  _nip 

mv; 

XT23  J>1  _mp 

V5 

XT23_V2_nip 

V , 

mXT2  3  J>2_mpm 

PU 

PU 


Node 

1 

4 

3 

6 


Node 

2 

5 

3 

6 
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C-2.3:  System  Variables  and  Equations 

There  are  nine  system  variable  and  equations  associated  with  this  example.  There 
are  the  six  node  potentials  plus  three  import  flow  variables  ordered  in  the  following 
manner: 

=  [V,  V2  y3  vt  v5  v6  iGlJ2  lGlJ ,  IG2J 

The  nine  system  equations  are  composed  of  six  Kirchhoff  Current  Law  equations  and 
three  potential  equations: 

8l(Xsys)  =  ^Gl_Q+XT12_Ql_ntf  +  XT13  _Q1  _ntf 
82  (*«*)  ~?G2  _Q  +XT12J22_nef  +  XT23  _Q1  _nef 
8j(xsys)  =  XU  _Q_ntf  +  +  XT23  Jj2_nef 

Sifajyt)  —Id _P  ~^'XT12J>l_nef'^XT13_Pl_ntf 
8S(Xsys)  ~  XC2  J>juf  +  -*772  +  JT2iJ7_n«/ 

8e(Xiy,)  =  XL3_P_nrf  +  XT13J32^  +  XT23_P2j*cf 
8\jGlv(Xsys )  =  Vl~XGl_V_nep 
82_G2_v(Xjys)  =  ^2  ~XG2_V_nrp 
8*_GIJ)(Xtys )  ~  V*~XGl_P,ncp 
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C-2.4:  System  Structural  Jacobian  Matrix 

The  equations  for  generating  the  system  jacobian  matrix  are  given  by: 

Jsysjj  ~  Jt12_Q1_V1  ~^^T13_Qiyi  +N 

Jrys_\jl  =  Jri2  _Q1  _V2  =  ^ 

=  Jt!3_Q1_V2  ~  N 

^xyj_l_4  =  +  ^ T13_Q1J>1  =  N  +  N 

^  xys_\_i  ~  Jri2  _Q1_P2~N 

/tm_  1_6  ~  Jri3 _Q1J)2=N 
Jsys_l_GlJ2  ~  I 


^ rys__2_\  ~  Jm _Q2_VI  =  N 
^ sys_7J2  ~  Jri2Jl2_V2  +Jt23_Q1J'1  =  N 
JiysJ2Jh  ~  Jt23  _Q1V2=N 
/ro_2_*  ~  Jri2_Q2  J)1  ~  N 
JiysJ2J  =  Jt12_Q2  J>2  +  ^ T23_Q1  J>1  =  ^  +  N 

J ryslj,  ~  Jt23_Q1J>2  ~  ^ 

J iys_2_G2_Q  =  ^ 
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J  sys_lj  =  Jti3_Q2_V1  =  N 
3 rjsjil  ~  Jt23  _Q2_Vl  ~  N 

J ryi_3_3  =  _Q_V  ^T13  _Q2JV2  ~^^T23  _Q2_V2  =  0  +  N  +  N 

=  ^T13_Q2  J>1  =  ^ 

^sysjij  ~  ^T23  _Q2_P1~N 

J sysjijt  ~  _Q_p  +Jri3_Q2J)2  +  ^T23  _Q2  J>2  ~  ®  +  ^  +  N 

gAx„.) 

^sys_ 4_1  ~^T12_P1_V1  +Jt13_P1_V1  =  ^  +  ^ 

3 sysji  2  —  J T12J>1_V2  ~  ^ 

=  ^ T13J>1_V2  ~  N 

Jsys_*_4  -  Jt12J>IJ>1  +^Tl3J>lJ)t  ~  +A/ 

/ryi_4_i  ~  ^ T 12  _P1  _P2  =  N 
Jjys_*_6  ~  J T13_P1  _P2~  N 

J*y*-*.G1  J—l 
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gs(x„.) 


Jjyjil  =  ^Tl2_P2\l  =  N 
J sy,_SJl  ~  J T12 J’2_V2  +  ^T23_P1_V1  ~N  +N 
J rys_5_3  ~  ^ T23  J>1  V7  ~  ^ 

Jtys_S_*  ~  ^T12_P2J>1  ~  N 

JsysJSJ  ~  ^ G2J>  J>  +  ^Tl 2 _P 2 _D2  +  ^T23  _P1  _D1  =  0  +N  +  N 
J iysif>  =  J T23_P1J)2  =  N 
J sys_G2  J2  ~  J G2_PJ2  ~  ® 

gA*v,) 

Jsy,_6_l  =  Jt13_P2_V1  =  ^ 

J jy>_6_2  =  ^T23  jnyi  =  N 

J sysjbji  —Ju  J>_V  +  Jt13_P2,V2  +  ^ T23  _P2V2  —  0  +  N  +  N 
Jrys_6_*  =  J T13_P2J>1  =  ^ 

Jrysj>_ 5  =  Jt23_P2_D1  ~  ^ 

J sysjbjb  ~  ^ T13  _P2  _D2  +  ^ T23_P2J)2  ~  0  +  N  +  N 
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giciAx  tyt) 

^  sys  _G1  _V_\  =  I 

3 sys_GlVG)  J?  =  ~JGiy_Q  ~  ® 

J sys _gi  y _gi  j  =  -Jciy_p  ~  0 

g2_C2_v(XV.) 

JsysjG2V_2  =  1 
J sysjG2V_i  ~  ~^G2_VJD  ~  ® 

^ sys  _G2y  _G2  _Q  ~  ~^G2V 


g4jG!J>(Xsys ) 

3 sys  Gl  J>y  ~  l 

J sys_GlJ>_Gl_Q  =  ~JgIJDJ2  =  ® 
J  sys  JGl  J>G1  J>  =  ~^GIJ)J>  ~  ® 
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By  applying  the  rules  of  Structural  Jacobian  element  arithmetic  on  the  system 
equations,  we  can  generate  the  following  system  Structural  Jacobian: 


~N 

N 

N 

N 

N 

N 

/ 

0 

O' 

N 

N 

N 

N 

N 

N 

0 

0 

I 

N 

N 

N 

N 

N 

N 

0 

0 

0 

N 

N 

N 

N 

N 

N 

0 

/ 

0 

•/„= 

N 

N 

N 

N 

N 

N 

0 

0 

0 

N 

N 

N 

N 

N 

N 

0 

0 

0 

I 

0 

0 

0 

0 

0 

0 

0 

0 

0 

I 

0 

0 

0 

0 

0 

0 

0 

.0 

0 

0 

I 

0 

0 

0 

0 

0 

Close  inspection  of  this  matrix  reveals  seven  blocks:  Six  lxl  element  blocks  and  one 
3x3  element  block: 

Block  1 

System  Row:  7 

System  Column:  1 

System  Variable:  V, 

Equations: 

8\_G1  v(Xiys)  =  ^1  ~XGl_V„ncp 


Structural  Jacobian: 


Block  2 


System  Row:  8 

System  Columns:  2 

System  Variable:  V2 

Equations: 

Structural  Jacobian: 

System  Row:  9 

System  Column:  4 

System  Variable:  V4 

Equations: 

Structural  Jacobian: 


82_G2_v(Xsys)  ~  ^2  XG2_V_nep 

JB2  =  [/] 

Block  3 

8* _Gl  ~  ~~  XG1  _D_nep 

/«  =  [/] 
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Block  4 


System  Rows:  3  5  6 

System  Columns:  3  5  6 

System  Variables:  V3  Vs  V6 

Equations: 

g&sys)  —  XU  _Q_nef  +  *113  _Q2_nej  XT23Jl2_nef 
8s(Xrys)  =  XG2J>_nef^rXT12J>2_n*f  +  XT23J>l_nef 
Sefcsyt )  =  XL3_P_nef  +  XT13_P2  _nef  +  XT23_P2_ntf 

Structural  Jacobian: 

~N  N  N' 

JB4=  N  N  N 
[_V  N  N_ 

Block  5 

System  Row:  1 

System  Column:  7 

System  Variable:  IG1J2 

Equations: 

gfcsys)  -  ^Gl_Q  +  XTl2_Ql_nef  +  XT13_Ql^nef 

Structural  Jacobian: 


-208- 


Block  6 


System  Row:  2 

System  Column:  8 

System  Variable:  IGI  j> 

Equations: 

Sl^sys)  ~  Ig2_Q  +XT12J22_n*f  +  XT23J21_>vf 

Structural  Jacobian: 

/«  =  [/] 

Block  7 

System  Row:  4 

System  Column:  9 

System  Variable:  IG2 ^ 

Equations: 

8*(xrys)  ~^GIJ  +XT12J’l_'xf+Xri3SJ_nef 


Structural  Jacobian: 


jb  7= in 
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C-2.5:  Solving  the  System 


Applying  the  equations  for  the  first  three  blocks  yields: 


~  fai_v 


_y  _nep 


^2  “ /c2_V_ i 


nep 


(ft 

■°T 

vLoJJ 


=  1.0  PU 


=  1.05  PU 


*We 


Gl  _D  _nq>  I 


=  0.0  PU 


Now  the  following  system  of  three  equations  for  the  fourth  block  must  be  solved: 


X  = 

error 


8s  (xB4,Xpre) 
86(xB4,xpre)J 


=  0 


Where: 


Starting  with  the  intial  guess  of  [1  0  0]T  for  xM  we  obtain  the  following  error  vector 
and  jacobian  matrix: 


'  0.1824  ' 

x°  = 

*error 

-0.4485 
.  0.5706  _ 

'  6.9412 

0.6176 

-1.7941' 

j°  - 
JB4 

-0.6176 

4.1176 

-  2.4706 

1.7253 

-  2.4706 

7.1765 
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Inverting  the  Jacobian  and  multiplying  by  the  error  vector  results  in  the  following 
correction  vector  for  : 


‘  0.0441  ‘ 
-0.0769 
0.0424 


*-B4 


By  repeating  the  Newton-Raphson  iterations  several  more  times,  the  following  table 
can  be  constructed: 


|  Iteration 

V, 

V5 

g>() 

gs  0 

£«() 

0 

1.0000 

0.0000 

0.0000 

0.1824 

-0.4485 

0.5706 

1 

0.9559 

0.0769 

-0.0424 

0.0289 

-0.0084 

0.0311 

2 

0.9502 

0.0762 

-0.0463 

2.284e-4 

-0.448e-4 

2.208e-4 

3 

0.9502 

0.0761 

-0.0464 

1.370e-8 

-0.2l4e-8 

1.240e-8 

From  these  results,  the  final  three  blocks  can  easily  be  solved: 

Aw = 

Igiji  -  *0.1451  PU 

Aw  JP  ~  ~fri2_P! _«/A*772_.)  ~fri3^Pl_nef(XT13_i) 

lCIF=- 0.1233  PU 

Aw _Q  =  ~JT12  J)2_n*f(XT12j)  ~fT23_Qlj*far23j) 

lG2M  =  -0.2483  PU 
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C-3:  Summary  of  Results 


Bus  1 


Bus  Voltage  Magnitude 

1.0  PU 

Bus  Voltage  Angle 

0.0  rad 

G1  Real/Reactive  Power 

-0.1233  PU 

-0.1451  PU 

T12  Real/Reactive  Power 

-0.1437  PU 

-0.0423  PU 

T13  Real/Reactive  Power 

0.2671  PU 

0.1874  PU 

Bus  2 

Bus  Voltage  Magnitude 

1.0500  PU 

Bus  Voltage  Angle 

0.0761  rad 

G2  Real/Reactive  Power 

-0.5  PU 

-0.2483  PU 

T12  Real/Reactive  Power 

0.1471  PU 

0.0558  PU 

T23  Real/Reactive  Power 

0.3529  PU 

0.1925  PU 

Bus  3 

Bus  Voltage  Magnitude 

0.9502  PU 

Bus  Voltage  Angle 

-0.0464  rad 

L3  Real/Reactive  Power 

0.6000  PU 

0.3000  PU 

T13  Real/Reactive  Power 

-0.2617  PU 

-0.1661  PU 

T23  Real/Reactive  Power 

-0.3383  PU 

-0.1339  PU 
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Appendix  D:  Modified  Load  Flow  Example 


Appendix  C  demonstrated  how  a  system  can  be  built  and  solved  for  a  conventional 
load  flow  problem.  This  example  demonstrates  how  control  signals  such  as  real  and  reactive 
power  sharing  signals  can  be  incorporated  in  the  load  flow  solution.  In  particular,  this 
example  connects  two  parallel  generators  to  a  load  via  a  transmission  line.  A  conventional 
load  flow  fails  for  this  example  because  the  generator  bus  voltage  magnitude  is 
overdetermined  and  there  is  no  relationship  for  sharing  reactive  power.  In  this  example, 
information  variables  are  used  to  force  each  generator  to  be  proportionally  loaded  and  have 
the  same  power  angle. 

Figure  D-l:  Parallel  Generator  Load  Flow  Example 


D-l:  Device  Definitions 


In  addition  to  the  transmission  line  and  PQ  load  defined  in  Appendix  C,  two  more 
devices  must  be  defined:  A  slack  bus  generator  incorporating  the  load  sharing  information, 
and  a  PQ  generator  employing  the  load  sharing. 
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D-l.l:  VDS  Generator  (Slack  Bus) 
Interface  Variables 


Terminal 


Potential  Variable  Flow  Variable  (KCL  Group)  Type 


VQ  V  (export)  Q  (import) 

DP  D  (export)  P  (import) 

p  p  (export) 

q  q  (export) 

The  import  x^p  and  export  xtxp  vectors  are  defined  by: 


(0)  Normal 
(0)  Normal 
Information 
Information 


JC,m„ 

imp 


m 


D 

P 

q 


Parameters 


VG  Scheduled  Generator  Voltage 

Dc  Scheduled  Generator  Angle 

PB  Scheduled  Generator  Power  Base 

Equations 


v  =  vc 

D=DC 


P 


Device  Structural  Jacobian 


The  device  structural  jacobian  is  given  by: 

’0  O' 

j  -  0  0 

Jds  0  L 

_N  Nm 
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Device  Jacobian 

The  device  jacobian  is  given  by: 


'0  0 
0  0 


I 

P  P 2 


-215- 


D-1.2:  PQS  Generator 
Interface  Variables 


Terminal 

Potential  Variable  Flow  Variable 

(KCL  Group)  Type 

VQ 

V  (import)  Q  (export) 

(0)  Normal 

DP 

D  (import)  P  (export) 

(0)  Normal 

P 

p  (import) 

Information 

q 

q  (import) 

Information 

The  import 

and  export  xexp  vectors  are  defined  by: 

m 


D 

P 


q 


Parameters 

PB  Scheduled  Generator  Power  Base 

Equations 


P=-PBp 


Q  =  -pBpq 


Device  Structural  Jacobian 


The  device  structural  jacobian  is  given  by: 


Jds  ~ 


0  0  N  N' 
0  0  L  0 


Device  Jacobian 


The  device  jacobian  is  given  by: 


Jd  — 


'0  0 

0  0 


-PBq 

-PB 


-pBp' 

0 
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D-2:  Network  Description 


Figure  D-2-1  is  a  block  diagram  of  the  system  represented  in  Figure  D-l: 

Figure  D-2-1:  Parallel  Generator  Example  Block  Diagram 


D-2.1:  Network  Specification 

Using  the  same  variable  labeling  convention  as  in  Appendix  C,  the  devices  and 
network  are  specified  by: 

VDS  Generator  G1 


Terminal 

VQ 

DP 

P 

q 

Parameters: 


Potential  Variable 

XGl_V_mp 

XGlJ>Jtep 

XGl_p_i*p 

XGI_q*ep 


Vc  1.05  PU 

Dg  0.00  rad 

PB  1.00  PU 


Import  Vector: 


Flow  Variable 

XG1  Q  Kif 
XG1  _P_n% 


Node 

1 

3 

5 

6 
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PQS  Generator  G2 


Terminal  Potential  Variable  Row  Variable 


VQ 

DP 

P 

q 

Parameters: 


XG2_V_mp 
XG2J),nip 
XG2  jjif 
XG2_q_0f 


PB  0.50  PU 

Import  Vector: 


XG1  Q  mtf 
XGl_P_ntf 


XG2_V_nip 

vv 

XG2J)_mp 

XG2_pJip 

.  XG2jiJip  _ 

- 1 

Transmission  Line  T12 


Terminal  Potential  Variable  Flow  Variable 


VQI 

XTt2_Vl~»ip 

XT12_Qlj»tJ 

DPI 

XT12 

XT12jnj*f 

VQ2 

XmV2_nip 

XT12_Q2jitf 

DP2 

XT12_D2_mlp 

XTl2_n_m*f 

Parameters: 

R 

0.05  PU 

X 

0.20  PU 

Import  Vector: 


i2j 


XT12Vl_mp 

'v; 

XT12_Dl_nip 

XT12V2jup 

_XT12J)2  jup  _ 

^4 

Node 
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7  04  »-* 


PQ  Load 

L3 

Terminal 

Potential  Variable 

Flow  Variable 

VQ 

XL3_V_mip 

XU_Q_iuf 

DP 

XL3_D_mip 

XU_P_Htf 

Parameters: 

PL 

0.60  PU 

ql 

0.10  PU 

Import  Vector: 


D-2.2:  System  Variables  and  Equations 


There  are  eight  system  variables  and  equations  associated  with  this  example.  There 
are  the  six  node  potentials  plus  two  import  flow  variables  ordered  in  the  following  manner: 

Xv  =  1Yi  v2  V2  v5  Ve  IG,Ji  Wf 

Tb~  eight  system  equations  are  composed  of  four  Kirchhoff  Current  Law  equations 
and  four  ootential  equations: 

Sl(xsys)  ~^G1  _Q+  XG2 +  -*772 jQl^nef 

8l(Xnj)  =  Xl3_Q_n*f  XT\2  _Q2  _ntf 
82  (Xiys)  =  / G1J  +  XG2_P.vf  +  XT12_P1  _rxf 
8S.Xsys)  =  XU_P_n€f  +  XT12~P2_ruf 
8i_Gl_v(Xr?s)  ~  ^1  ~XGl_V_nrp 
82, G1  _D(Xsys)  =  V}—  XGlJ)_nep 
82  GI _p(Xiyj)  ~~  ^  5  XG1  _p_iep 
8 t_Gl  t]  (Xjyj  )  '  ^  6  XGl  _q_iep 
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D-2.3:  System  Structural  Jacobian  Matrix 


Using  the  device  structural  jacobian  matrices  along  with  the  system  equations,  the 
following  system  structural  jacobian  can  be  created: 


'N 

N 

N 

N 

N 

N 

/ 

0 

N 

N 

N 

N 

0 

0 

0 

0 

N 

N 

N 

N 

L 

0 

0 

I 

N 

N 

N 

N 

0 

0 

0 

0 

I 

0 

0 

0 

0 

0 

0 

0 

0 

0 

I 

0 

0 

0 

0 

0 

0 

0 

0 

0 

I 

0 

0 

L 

0 

0 

0 

0 

0 

I 

N 

N 

Applying  the  system  reduction  algorithms,  five  blocks  can  be  identified:  two  lxl 
element  blocks  and  three  2x2  element  blocks: 

Block  1 

System  Row:  5 

System  Column:  1 

System  Variable:  V, 

Equation: 

8l_GJ_v(Xsys)  =  ^1  XG1  _V_nrp 

Structural  Jacobian: 

JB,  =  [/] 
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Block  2 


System  Row:  6 

System  Column:  3 

System  Variable:  V3 

Equation: 


Structural  Jacobian: 


Sl_GlJ){Xsys)  ~  ^3  XG1  J>. 


■n<p 


JB2  =  U] 


Block  3 


System  Rows:  2  4 

System  Columns:  2  4 

System  Variables:  V2  V4 

Equations: 


g2(Xsys)  -  XL3_Q_nef  +  XT12_Q2_n*f 


8*(Xsys)  ~  XUJ>_ntf  +  XT12_P2_nef 


Structural  Jacobian: 


Block  4 


System  Rows:  3  7 

System  Columns:  5  8 

System  Variables:  V5  IGI  P 

Equations: 


8d>(Xsys)  =  ^GlJ>JrXG2_P_nefJt'XTnj>l_nef 
S5_Gl_p(Xsys )  =  ^5  ~XGl_p_it 


-*P 


Stmctural  Jacobian: 


Block  5 


System  Rows:  1  8 

System  Columns:  6  7 

System  Variables:  V6  IG1  ^ 

Equations: 

8l(Xsys)  ~  ^Gl_Q+XG2J2_nef  +  XTI2_£l_n^ 


86_G1  _<i(Xsyi)  ~  ^6  XGl_q. 


"P 


Stmctural  Jacobian: 


D-2.4:  Solving  the  System 


Applying  the  equations  for  the  first  two  blocks  yields: 


V>=fc 


Gl_V_nep\ 


V3=fc 


G1_Pj*p\  \  q 


=  1.05  PU 


=  0.0  rad 


The  remaining  blocks  are  systems  of  2x2  equations  and  unknowns.  Blocks  3  and  5 
are  nonlinear  and  must  be  solved  iteratively.  Block  4  is  linear  block  requiring  only  one 
iteration: 

Block  3: 


1.0000 

0.0000 

1.0000 

-0.1095 

0.9933 

-0.1105 

0.9933 

-0.1105 

n 


0 


1 


g2  0 

g*() 

-0.1353 

0.5414 

0.0293 

0.0085 

S  2.017e-4 

0.841e-4 

|  1.046e-8 

0.569e-8 

Igi f 

giO 

ga  j>0 

1.0000 

1.0000 

1.1188 

2.0000 

0.4125 


-0.4125 


0.0000 


0.0000 


0.0000 


0.2828 


0.0000 


-0.1167 


I  *,<> 

£d q() 

0.1750 

0.0000 

O.OOOe-8 

-0.0O0e-8 

D-3:  Summary  of  Results 


Bus  1 


Bus  Voltage  Magnitude 

1.05  PU 

Bus  Voltage  Angle 

0.00  rad 

G1  Real/Reactive  Power 

-0.4125  PU 

-0.1167  PU 

G2  Real/Reactive  Power 

-0.2063  PU 

-0.0583  PU 

T12  Real/Reactive  Power 

0.6188  PU 

0.1750  PU 

Bus  2 

Bus  Voltage  Magnitude 

0.9933  PU 

Bus  Voltage  Angle 

-0.1105  rad 

L3  Real/Reactive  Power 

0.6000  PU 

0.1000  PU 

T12  Real/Reactive  Power 

-0.6000  PU 

-0.1000  PU 

Information  Node  5  (p) 

Magnitude 

0.4125 

Information  Node  6  ( q ) 

Magnitude 

0.2828 
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Appendix  E:  Waveform  Examples 
E-l  Examples  of  Waveform  Types 

While  the  possibilities  of  waveform  definitions  is  endless,  this  thesis  will  concentrate 
on  the  following  waveform  types: 


Waveform  Type 

Code 

Undefined 

0 

Data  Series 

1 

Fourier  Series 

2 

Legendre  Series 

3 

Polynomials 

4 

Madab  Polynomials 

5 

Chebyshev  Series 

6 

The  code  in  the  above  table  refers  to  the  value  of  the  type  element  in  the  waveform 
structure. 

E-l.l  Data  Series 

A  data  series  consists  of  n  equally  spaced  samples  of  the  waveform  stored  in  an  array 
of  double  precision  floating  point  numbers.  The  first  coefficient  is  associated  with  the 
value  of  the  waveform  at  the  beginning  of  the  time  interval  and  the  last  coefficient  is 
associated  with  the  value  of  the  waveform  at  the  end  of  the  time  interval.  Each  element  of 
the  array  is  given  by: 

ct*m 

i  =  1,2,  ...,n 

A  data  series  representation  is  primarily  used  for  plotting  the  time  history  of 
variables  and  for  calculating  waveform  operators  which  would  prove  difficult  with  other 
waveform  types. 
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E-1.2  Polynomial  Expansion 

A  polynomial  expansion  consists  of  n  coefficients  of  a  polynomial  representation  of 
the  waveform  normalized  over  the  interval  [-1  U. 

f(x)=  i  c,x-' 

i-1 

t-t0 

x  =-l+2 - - 

h-to 

Polynomial  expansions  are  useful  for  evaluating  switching  operators  described 
above. 

A  Matlab  Polynomial  expansion  is  expressed  in  descending  order: 

/(*)  =  I  cixn~‘ 

i  •  1 

E-1.3  Orthogonal  Function  Series 

Orthogonal  Function  Series  can  be  an  excellent  means  for  representing  waveforms. 
In  an  orthogonal  series  representation,  the  value  of  the  coefficient  of  a  given  order  of  the 
characteristic  function  is  independent  of  the  number  of  terms  in  the  orthogonal  series.  This 
means  truncating  an  orthogonal  series  by  eliminating  higher  order  coefficients  will  still 
result  in  the  best  possible  fit  with  the  remaining  coefficients. 

In  general,  an  orthogonal  series  representation  is  of  the  form: 

f(x)  =  i  C;F;_t(x) 

X  €  X,] 

where  F/x)  is  the  ith  order  characteristic  function  of  the  orthogonal  function  series 
with  respect  to  the  weighting  function  r(x).  These  characteristic  functions  observe  the 
following  property: 
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J  r(x)F„(x)Fn(x)dx  =  0  for  m*n 

■*o 

xl 

j*  r(x)Fm(x)Fln(x)dx  =G(m) 

•*o 

With  this  property,  the  coefficients  c,  of  the  series  can  be  found: 

C'=G^l)lr(xV{X>F-'{X)dX 

*0 


E-l.3.1  Fourier  Series 

Perhaps  the  most  widely  used  orthogonal  function  series  is  the  Fourier  Series. 
Unfortunately,  the  Fourier  Series  is  unsuitable  for  dynamic  simulations.  To  see  why,  one 
need  only  look  at  the  manner  in  which  a  function  is  expressed  in  a  Fourier  Series: 

n  n 

f(x)  =  \  +  X  A;  cos (i7tx)  +  £  B,  sin(/  kx) 

i - 1  i-l 


X  = 


-1+2 


t-t o 
t\  —  t0 


Notice  that  at  x  =  1  and  x  =  -1  sin(iTUr)  =  0  and  cos(i7ix)  =  (-1)'  .  Consequently 
f(l)  =  f(-l).  In  other  words,  the  starting  value  and  ending  value  of  any  waveform 
represented  by  a  fourier  series  is  forced  to  be  identical.  In  dynamic  simulations  however, 
we  often  have  equations  of  the  form: 

dy 


This  equation  is  normally  evaluated  by  integration: 


y  =  y0+  j  f(z,i)dx 

b 
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where  y0  is  the  value  of  the  waveform  y  at  the  beginning  of  the  interval.  If  y  is 
represented  by  a  Fourier  Series,  then  y  evaluated  at  the  end  of  the  interval  will  also  be  y0. 
In  other  words,  while  the  value  of  a  state  variable  may  change  within  the  interior  of  a 
time  interval,  at  the  boundaries,  the  value  is  constrained  to  be  a  constant  independent  of 
the  length  of  the  time  interval.  This  constraint  is  artificial  and  not  a  property  of  real 
physical  systems. 

E-l.3.2  Legendre  Series 


Legendre  Series  use  legendre  polynomials  to  form  the  basis  of  an  orthogonal 
function  series  over  the  interval  [-1 1].  Legendre  polynomials  L,{x)  of  order  i  are  defined 
by  the  following  equations: 


L;(x)  = 


«,■(*) 

«,-(!) 


for 


even 


L,{x)  = 


V;(X) 


v,(l) 


for  i  odd 


,s  ,  |(/  +  1)  2  .i(/-2)(i  +  l)(i  +  3)  4  i  (i  -  2)  (/  -  4)  (/  + 1)  (/  +  3)  (i  +  5)  6  , 
“•■(*) sl - 5TX  +  4!  x - 6! 


3! 


5! 


(i  -  1)0'  -3)(i  -5)(f  +  2)(i  +4)(i  +6)  7 
7! 


The  first  six  Legendre  polynomials  are  readily  found  to  be: 

U*)=  1 


Lt(x)  =  x 


L2(x)^(3x2-1) 
L3(jc)  =  i(5x3-3x) 
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Legendre  Series  also  obey  the  following  recursion  formula 
(n  + 1)4  +  iC*)  =  (2  n  +  ljxZJx)  -  nL„  _  ,(x) 


An  «th  order  legendre  series  representation  of  a  waveform  is  given  by: 

/(*)=  X  c;L;_,(x) 

I  ■  1 


where: 


x0  =  -l 


x,  =  l 
r(jr)  =  1 
F,(x)  =  L,(x) 


G(0  = 


2 

2/  +  1 


The  time  interval  [/„  /,]  can  be  mapped  to  the  interval  [-1 1]  with  the  following 
transformation: 


h  ~  to 

The  coefficients  c,  can  be  found  by  integration: 

2/  —  i  r 

c,  ]f{x)L,_x{x)dx 

-i 

E-l.3.3  Chebyshev  Series 

Chebyshev  Series  use  Chebyshev  polynomials  to  form  the  basis  of  an  orthogonal 
function  series  over  the  interval  [-1 1],  Chebyshev  polynomials  F/x)  of  order  *  are 
defined  by  the  following  equations: 


Ux)=  1 
Ux)  =  x 

ri  +  1(jc)  =  2x7i(Ar)-7’i.I(x)  for  />1 
The  following  three  Chebyshev  polynomials  are  given  by: 

72(x)  =  2x2-1 

T3(x)  =  4x*-3x 
T4(x)  =  Zxa-&x2  +  1 

An  nth  order  Chebyshev  Series  representation  of  a  waveform  is  given  by: 

where 

*0  =  -l 
^i  =  l 

the  weighting  function  r(x)  is  given  by: 

rW=vrb 

and: 

F,(x)  =  TXx) 

G(0)  =  n 

G(m)  =  ~  for  n?>0 
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E-2  Waveform  Conversions 


This  section  describes  how  to  convert  a  waveform  consisting  of  a  vector  of 
coefficients  of  order  rt,  to  a  waveform  of  possibly  a  different  type  composed  of  a  vector  of 
coefficients  of  another  order  n2.  In  all  cases,  the  conversion  is  a  linear  matrix  operator. 
Hence  for  given  values  of  nt  and  n2,  the  conversion  matrix  need  only  be  calculated  once. 

From  here  on,  L/x)  refers  to  a  vector  containing  the  polynomial  coefficients  of  the  rth 
order  Legendre  Polynomial.  L^x)  refers  to  the  rth  order  Legendre  Polynomial  evaluated  at 
Xj.  Likewise,  T^x)  refers  to  a  vector  containing  the  polynomial  coefficients  of  the  fth  order 
Chebyshev  Polynomial.  T^xJ)  refers  to  the  fth  order  Chebyshev  Polynomial  evaluated  at  x». 

E-2.1  Legendre  Series 
E-2.1.1  Legendre  Series  to  Data  Series 


Converting  a  Legendre  Series  of  order  n2  to  a  data  series  of  order  n2  requires  the 
construction  of  the  following  matrix: 


1  L.CXo) 

^(Xo) 

•••  Ln_i(x0) 

1  L,(x,) 

LM 

1 

LM 

- 

1 

x,  =  -1  +  2 


n-y-l 


If  C,  is  the  vector  of  the  Legendre  Series  coefficients  and  C4  is  the  vector  of  data 
series  points,  the  following  relation  holds: 

Cj  ~  AWC, 

E-2.1.2  Legendre  Series  to  Legendre  Series 

Converting  a  Legendre  Series  of  order  rt,  to  order  n2  requires  only  the  truncation  of 
terms  if  n,  >  n2  or  the  insertion  of  zeros  in  the  higher  order  terms  if  rtt  <  n2. 
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E-2.1.3  Legendre  Series  to  Chebyshev  Series 


Converting  a  Legendre  Series  of  order  it,  to  a  Chebyshev  Series  of  order  rt2  first 
requires  the  truncation  or  padding  with  zeros  of  the  Legendre  series  to  order  n2.  The 
resulting  Legendre  Series  should  then  be  multiplied  by  the  following  upper  trianglular 
matrix: 


^li  -  At 

Al  =  [£<>(*)  L,(x)  Lj(x)  ...  I^_,(x)] 

At  =  [Ux)  Ux)  T2(x)  ...  T^ix)] 

where  L,{x)  is  a  vector  of  order  n2  holding  the  polynomial  coefficients  of  the  *th  order 
Legendre  Polynomial  and  T,(x)  is  a  vector  of  order  n2  holding  the  polynomial  coefficients 
of  the  ith  order  Chebyshev  Polynomial. 

E-2.1.4  Legendre  Series  to  Polynomial  Expansion 

Converting  a  Legendre  Series  of  order  nt  to  a  polynomial  expansion  of  order  n2  first 
requires  the  truncation  or  padding  with  zeros  of  the  Legendre  series  to  order  n2.  The 
resulting  Legendre  Series  vector  should  then  be  multiplied  by  the  following  upper 
triangular  matrix: 

=  ^mC*)  ^2.{x)  ...  LFlj_,fx)] 

where  L/jc)  is  a  vector  of  order  n2  holding  the  polynomial  coefficients  of  the  zth  order 
Legendre  Polynomial. 
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E-2.2  Chebyshev  Series 

E-2.2.1  Chebyshev  Series  to  Data  Series 

Converting  a  Chebyshev  Series  of  order  n,  to  a  data  series  of  order  n2  requires  the 
construction  of  the  following  matrix: 

'1  r,(x0)  T2(x o)  ...  rBi_,(x o) 

1  TM  T2{xx)  ...  Tn^(xx) 

i  r,(xj)  r2(x2)  ...  rBi  _,(**) 

^ro  = 

1  ^2(^-1)  ••• 


If  C,  is  the  vector  of  the  Chebyshev  Series  coefficients  and  Cd  is  the  vector  of  data 
series  points,  the  following  relation  holds: 

Cj  =  AtvC, 

E-2.2.2  Chebyshev  Series  to  Legendre  Series 

Converting  a  Chebyshev  Series  of  order  n2  to  a  Legendre  Series  of  order  n2  first 
requires  the  truncation  or  padding  with  zeros  of  the  Chebyshev  series  to  order  n2.  The 
resulting  Chebyshev  Series  should  then  be  multiplied  by  the  following  upper  trianglular 
matrix: 

Alt  —  AL  At 

=  L,(x)  L2(x)  ... 

Ar  =  [W  r,(x)  T2(x)  ...  T^ix)] 

where  L,{x)  is  a  vector  of  order  n2  holding  the  polynomial  coefficients  of  the  ith  order 
Legendre  Polynomial  and  T^x)  is  a  vector  of  order  n2  holding  the  polynomial  coefficients 
of  the  ith  order  Chebyshev  Polynomial. 
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E-2.2.3  Chebyshev  Series  to  Chebyshev  Series 

Converting  a  Chebyshev  Series  of  order  nl  to  order  n2  requires  only  the  truncation 
of  terms  if  n1  >  n2  or  the  insertion  of  zeros  in  the  higher  order  terms  if  n2  <  n2. 

E-2.2.4  Chebyshev  Series  to  Polynomial  Expansion 

Converting  a  Chebyshev  Series  of  order  n2  to  a  polynomial  expansion  of  order  n2 
first  requires  the  truncation  or  padding  with  zeros  of  the  Chebyshev  series  to  order  n2. 
The  resulting  Chebyshev  Series  vector  should  then  be  multiplied  by  the  following  upper 
triangular  matrix: 

At  =  (T0(x)  T2(x)  T2{x)  ... 

where  T,{x)  is  a  vector  of  order  n2  holding  the  polynomial  coefficients  of  the  zth  order 
Chebyshev  Polynomial. 
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E-2.3  Polynomial  Expansion 
E-2.3.1  Polynomial  Expansion  to  Data  Series 


Converting  a  polynomial  expansion  of  order  n ,  to  a  data  series  of  order  n2  requires 
the  construction  of  the  following  matrix: 


Apo  - 


1  x0 
1  x, 
1 


I  x  x2 

n,- 1  *iu-l  ” 


r"1-1 

S-' 


x,  =  — 1  +2- 


n 2-1 


IfC,  is  the  vector  of  the  polynomial  coefficients  and  Cd  is  the  vector  of  data  series 
points,  the  following  relation  holds: 

Cd  =  APDCp 

E-2.3.2  Polynomial  Expansion  to  Legendre  Series 

Converting  a  polynomial  expansion  of  order  nl  to  a  Legendre  Series  of  order  n2 
requires  first  converting  to  a  Legendre  series  of  order  n2  then  converting  the  Legendre 
Series  to  order  n2.  Recall  that  the  matrix  for  converting  from  a  Legendre  Series  to  a 
Polynomial  is  upper  triangular.  Hence  one  only  needs  to  use  backward  substitution  to 
solve  for  the  Legendre  Series  coefficients: 

/1l  =  [L0(x)  L{{x)  L2(x)  ...  L^.,0 r)] 

Cp  =  AlC, 

E-2.3.3  Polynomial  Expansion  to  Chebysbev  Series 

Converting  a  polynomial  expansion  of  order  n7  to  a  Chebyshev  Series  of  order  n2 
requires  first  converting  to  a  Chebyshev  series  of  order  n2  then  converting  the  Chebyshev 
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Series  to  order  n2.  Recall  that  the  matrix  for  converting  from  a  Chebyshev  Series  to  a 
Polynomial  is  upper  triangular.  Hence  one  only  needs  to  use  backward  substitution  to 
solve  for  the  Chebyshev  Series  coefficients: 

At=[Ux)  Ux)  T2(x)  ...  T^ix)] 

Cp=ArC, 

E-2.3.4  Polynomial  Expansion  to  Polynomial  Expansion 

Converting  a  polynomial  expansion  to  another  polynomial  expansion  of  higher 
order  only  requires  setting  the  higher  order  terms  to  zero.  Converting  to  a  lower  number 
of  terms  requires  more  effort.  The  best  method  is  to  convert  to  an  orthogonal  function 
series,  truncate,  and  convert  back.  Since  all  of  these  operations  are  linear  matrix 
operations,  the  conversion  matrix  need  only  be  calculated  once.  For  this  conversion, 
either  the  Legendre  Series  or  the  Chebyshev  series  would  be  appropriate  since  the  type 
conversions  to  and  from  the  series  solution  does  not  add  any  truncation  error  (The 
truncation  error  is  solely  due  to  the  truncation  of  the  Legendre  Series  or  Chebyshev  series 
and  not  due  to  the  conversions). 
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E-2.4  Data  Series 


E-2.4.1  Data  Series  to  Data  Series 

There  are  many  methods  for  converting  a  data  series  to  another  data  series  with  a 
different  number  of  coefficients.  Two  common  interpolation  schemes  for  performing  this 
conversion  are  linear  interpolation  and  cubic  splines.  These  methods  can  be  found  in 
many  numerical  methods  textbooks  and  will  not  be  described  here. 

E-2.4.2  Data  Series  to  Legendre  Series 

If  n,>n2,  a  Data  Series  can  be  converted  to  a  Legendre  Series  by  taking  the 
pseudo-inverse  of  the  matrix  converting  a  Legendre  Series  to  a  Data  Series.  1inl<n2,  the 
Data  Series  can  be  converted  in  a  similar  manner  to  a  Legendre  Series  of  order  n/  padded 
with  zeros  to  order  n2. 

V.W 


•••  v><v>)J 

I 

If  Cd  is  the  vector  of  data  series  points  and  C,  is  the  vector  of  Legendre  Series 
Coefficients,  the  following  relation  holds: 

Cj  =  AWC, 


*LD 


1  £iC*o) 

1  L,(xt) 

1  LjCtJ 


■^2(^0) 

14.x,) 


1  L\(xnj-i) 


x-  =  -1+2- 


C/  —  AwCj 


E-2.4.3  Data  Series  to  Chebyshev  Series 

Converting  a  Data  Series  to  a  Chebyshev  Series  can  be  done  in  the  same  manner  as 
the  conversion  to  a  Legendre  Series: 
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Tx{x o)  T2(x0)  ... 

W  %)  ...  7'^_1(JC1) 

T’i(^)  T'a(^)  •••  7*-1.i(*a) 


E-2.4.4  Data  Series  to  Polynomial  Expansion 

Convening  a  data  series  to  a  polynomial  expansion  of  equal  or  less  order  using  a 
least  squares  fit  is  a  straight  forward  process.  If  the  number  of  points  in  the  data  series  nt 
is  equal  to  or  less  than  the  number  of  points  in  the  polynomial  n2,  the  resulting 
polynomial  will  pass  through  each  point  of  the  data  series.  If  larger,  the  polynomial  will 
not  necessarily  pass  through  all  of  the  data  series  points,  but  will  be  a  least  square 
approximation. 

For  ttj  <  n2 : 

For  this  case,  the  problem  is  to  solve  for  the  coefficients  of  the  polynomial  for 
i  <  it,.  For  the  higher  coefficients  (f  >  n7),  =  0.  In  the  following  discussion,  let  C4  be 

the  vector  of  n2  data  series  coefficients  and  Cf  be  the  vector  containing  the  first  nl 
polynomial  coefficients.  Define  the  n2  x  n2  matrix  A  as  follows: 
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x,  =-1+2 


i 

n  i-l 


Matrix  APD  is  square,  clearly  has  rank  nt,  and  therefore  is  invertible.  Consequently 
solving  for  Cp  is  straight  forward: 

^PD^~p  ~  Cj 

Cp  =  APDCd 

For  n,  >  n2 : 

If  the  number  of  data  points  is  greater  than  the  number  of  polynomials,  the  number 
of  columns  in  the  APD  matrix  described  above  would  have  n2  columns  and  nl  rows.  APO 
would  clearly  not  be  invertible.  The  pseudo-inverse  of  APD  can  be  calculated  and 
provides  the  least  squares  fit  of  the  data  series: 
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E-3  Waveform  Arithmetic 


This  section  describes  how  to  perform  addition,  subtraction,  multiplication,  and 
division  on  the  various  types  of  waveforms. 

E-3.1  Data  Series 

Performing  waveform  arithmetic  on  data  series  is  very  easy.  The  waveforms  are 
converted  to  the  proper  size  and  then  added,  subtracted,  multiplied  or  divided  element  by 
element. 

E-3.2  Polynomials 
E-3.2.1  Addition/Subtraction 

Adding  or  subtracting  two  polynomial  waveforms  simply  entails  converting  the  two 
waveforms  to  the  proper  length  and  adding  or  subtracting  element  by  element. 

E-3.2.2  Multiplication 

Multiplying  polynomial  waveform  W  of  size  nw  and  Y  of  size  ny  together  to  get 


polynomial  Z  of  size  nw  +  ny  -  1 

can 

be  accomplished  by  constructing  the  following 

matrix  of  size  nw  +  ny  -  1  x  nw 

0 

0 

0  ... 

0 

0  * 

y2 

Y, 

0 

0  ... 

0 

0 

Y3 

y2 

Y, 

0  ... 

0 

0 

Y< 

y3 

y2 

y,  ... 

0 

0 

M„  = 

• 

• 

• 

• 

• 

• 

0 

0 

0 

0  ... 

r-. 

V’ 

0 

0 

0 

0  ... 

0 

1 _ 

z  = 

MpW 

Z  can  now  be  truncated  or  padded  with  zeros  to  convert  it  to  the  proper  length.  The 
truncation  of  a  polynomial  is  discussed  in  section  E-2.3.4. 
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E-3.2.3  Division 


Dividing  two  polynomial  expansions  can  be  difficult,  particularly  if  the 
denominator  polynomial  has  one  or  more  zero  crossings.  In  general,  there  is  no  simple 
method  for  performing  the  division,  although  the  recursion  process  described  in  this 
section  will  work.  Define  the  problem  to  be: 


£  y/-1 


I  Bx‘ ~5 

I  c*x‘-' 

*  - 1 


There  are  two  parts  to  the  problem.  The  first  task  is  to  use  synthetic  division  until 
the  numerator  of  the  remainder  is  of  size  rtc  -1  or  less.  The  second  task  is  to  convert  the 
remaining  fraction  into  another  polynomial  expansion  by  a  process  similar  to  synthetic 
division,  but  proceeding  from  the  constant  term  and  working  up  in  order. 

Synthetic  division  is  the  process  of  dividing  one  polynomial  by  another  until  the 
remainder  is  of  order  1  less  than  the  denominator. 


/-i 


I 


11,-1 

I  r,xl~l 


l-l 


*e 

I 

km  1 


y flnd-n€  +  \) 


Initially,  dt  is  set  equal  to  b,.  After  the  first  iteration,  d,  is  set  equal  to  the  remainder 
rt.  The  process  is  repeated  until  n4=nc- 1.  At  this  point,  the  direction  of  the  division  is 
reversed  and  we  get: 


£  d,x  .  I  r,xl 

i-i  a\  ,  i-i 

- ~  —  +x - 

"c  Cl  "c 

I  Ctxk-1 

t-i  *-i 
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In  this  manner,  we  can  express  the  remaining  fraction  as  another  polynomial 
expansion.  The  actual  values  for  T,  are  equal  to  the  sum  of  the  components  from  the 
forward  and  backwards  synthetic  division. 

Note  that  if  the  denominator  has  a  zero  over  the  interval  [-1,1],  the  backwards 
synthetic  division  will  result  in  a  diverging  series. 
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E-3.3  Legendre  Series 
E-3.3.1  Addition/Subtraction 

Adding  or  subtracting  two  Legendre  Series  waveforms  simply  entails  converting  the 
two  w'aveforms  to  the  proper  length  and  adding  or  subtracting  element  by  element. 

E-3.3.2  Multiplication 

Multiplying  two  Legendre  Series  together  can  be  accomplished  in  two  ways.  The 
first  way  is  to  convert  the  Legendre  Series  to  polynomial  expansions,  multiply  the  two 
together,  then  convert  the  product  to  the  Legendre  Series  of  the  proper  size.  The  second 
method  uses  the  recursion  formula  for  the  Legendre  series  to  assist  in  the  process: 

To  multiply  Legendre  Series  Y  of  size  ny  by  the  Legendre  Series  W  of  size  nw  to 
obtain  the  Legendre  Series  Z  of  size  rtz  =  ny  +  nw  - 1,  Y  must  first  be  converted  to  a 
polynomial  expansion  Yp  of  size  ny. 

Al  =  [L0(x)  Lx(x)  L^x)  ...  _,(*)] 

YP=AJ 

The  recursion  formula  for  the  Legendre  Series  is  given  by: 

which  can  be  translated  into  the  following  matrix  for  multiplying  a  given  Legendre 
Series  of  size  nt  by  x : 
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0  0 


0  0 
0  0 
0  0 


0 

0 

0 

0 

2(n,  -  2)  + 1 

0 

2(n.  -  2)  + 1 


If  we  define  the  vector  Yfi  to  be  Yp  padded  with  zeros  such  that  it  is  of  size  nv  we 
can  define  the  following  nz  x  nw  matrix: 

Ampt  =  [YpI  AXIYpl  A^AxjYpj  ...  YplJ 

The  final  nz  x  nw  multiplication  matrix  AmU  can  now  be  found: 

Amii  ~  Amp,AL 


Z-A 


mil 


W 


Of  course  Z  may  have  to  be  truncated  or  padded  with  zeros  to  convert  it  to  the 
desired  length. 

E-3.3.3  Division 


There  is  no  straight  forward  method  for  dividing  two  legendre  series.  The  easiest 
way  appears  to  be  converting  to  polynomial  expansions,  performing  the  divison,  then 
converting  back  to  the  legendre  series. 
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E-3.4  Chebyshev  Series 
E-3.4.1  Addition/Subtraction 

Adding  or  subtracting  two  Chebyshev  Series  waveforms  simply  entails  converting 
the  two  waveforms  to  the  proper  length  and  adding  or  subtracting  element  by  element. 

E-3.4.2  Multiplication 

Multiplying  two  Chebyshev  Series  together  can  be  accomplished  in  two  ways.  The 
first  way  is  to  convert  the  Chebyshev  Series  to  polynomial  expansions,  multiply  the  two 
together,  then  convert  the  product  to  the  Chebyshev  Series  of  the  proper  size.  The  second 
and  preferred  method  uses  an  alternate  definition  of  a  Chebyshev  Polynomial  to  assist  in 
the  process: 

Tn{x )  =  cos(n  cos"'(x)) 

T^(x)  =  Tn(x) 

From  this  definition,  the  product  of  two  Chebyshev  Polynomials  can  easily  be 
derived: 

Tn(x)TJx)  =  cos(n  cos~'(jc))cos (m  cos“'(x)) 

T„(x)Tm (x)  =  ^  (cos ((/i  +  m ) cos'\x))  +  cos ((n  -  m )  cos~'(x))) 

r.MTjx) = + T,  _„«) 

To  multiply  Chebyshev  Series  Y  of  size  n}  by  the  Chebyshev  Series  W  of  size  nw  to 
obtain  the  Chebyshev  Series  Z  of  size  nz  =  ny  +  nw  - 1,  three  nt  x  nw  matrices  should  first 
be  constructed: 
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F,  0  0  ...  0  0 

Y2  Yl  0  ...  0  0 

y3  y2  r,  ...  o  o 


A 


mil 


0  0  0 
0  0  0 


Anf2  — 


■y. 

y2 

r> 


y2  y3  ... 

y3  y4  ... 

y4  y5  ... 


o  o 

0  Y, 


A ml} 


0  0 
0  0 


0  0  ... 

y2  y3  ... 

Y>  Y2  ... 

o  r,  ... 


The  final  nt  x  nw  multiplication  matrix  A is  given  by: 

^mn  —  2  (^mtl  ^mi2 
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Of  course  Z  may  have  to  be  truncated  or  padded  with  zeros  to  convert  it  to  the 
desired  length. 

E-3.4.3  Division 

There  is  no  straight  forward  method  for  dividing  two  chebyshev  series.  The  easiest 
way  appears  to  be  converting  to  polynomial  expansions,  performing  the  divison,  then 
converting  back  to  the  chebyshev  series. 
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E-4  Waveform  Functions 


E-4.1  Data  Series 

E-4.1.1  Trigonometric  and  Exponential  Functions 

All  trigonometric  and  exponential  functions  can  be  performed  point  by  point  on  the 
data  series  coeff  Tents. 

E-4.1.2  Integration  and  Differentiation 

There  are  a  number  of  techniques  for  integrating  or  differentiating  Data  Series.  All 
are  by  their  nature  approximations  and  can  suffer  from  numerical  instability  problems 
associated  with  conventional  simulations.  One  simple  method  of  integration  employs  the 
trapezoidal  rule: 

"0  0  0  0  0  ...  0  0  0 

^^000...  000 
2  2 

h  ,  h  n 

-  h  -  00...  000 

2  2 

^  h  h  ^  0...  000 

2  2 

%  h  h  h  ^  0  0  0 

S  =  2  2 

^  h  h  h  h  ...  ^00 

2  2 

h  h  h  h  ...  h  -  0 

2  2 

-  h  h  h  h  ...  h  h 

2  2 


With  this  matrix,  the  integral  equation: 
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Becomes  the  matrix  operation: 


Y  =  Y0+  j  Wdx 

t—  i 


y=sddw+y0 


The  vector  Y  may  be  now  converted  to  a  different  length  if  so  desired. 

Differentiating  a  Data  series  can  be  done  in  a  number  of  ways.  The  secant  method 
can  be  easily  implemented  with  the  following  matrix: 


-1 

1 

2 

0 


1 

0 

1 

“2 

0 


0 

1 

2 

0 

1 

~2 


0  0 
0  0 


0  0  0' 

0  0  0 

0  0  0 

0  0  0 


0  0  o  0  0  ...  0  i 

2  2 

0  0  0  0  0  ...  0  -1  1 


Another  approach  is  to  choose  a  differentiation  matrix  such  that  it  is  consistent  with 
the  integration  matrix.  Consistency  is  defined  by  the  following  matrix  equation: 

^DD^DD2  =  M 


where 
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■  0 

0 

0 

0  .. 

-1 

1 

0 

0  .. 

-1  0 

1 

0  .. 

-1  0 

0 

1  .. 

The  M  matrix  reflects  the  fact  that  differentiating  a  data  series  will  destroy  the 
subsequent  constant  of  integration.  Since  Sdd  is  generally  singular,  only  its 
pseudo-inverse  can  be  taken: 

^DD2  =  (^DO^Dd) 

This  matrix  actually  has  a  very  simple  construction: 

2/2-3  2/1-5  2/1-7 
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2n  -9 
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2n-9 

n 

2n  -9 
n 

2n -9 
n 

d5  5 


d„  is  equal  to  the  the  negative  sum  of  all  the  other  terms  in  the  xth  row.  As  a 
consequence,  all  of  the  row  sums  of  Dddi  are  equal  to  zero  and  DDD2  is  singular. 

E-4.1.3  Switching  Functions 

All  switching  functions  can  be  performed  point  by  point  on  the  data  series 
coefficients. 
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E-4.1.4  Waveform  Smoothing 


There  are  times  when  it  may  be  desirable  to  remove  high  spectral  content  features 
of  a  waveform.  One  way  to  do  this  is  to  replace  the  value  at  each  point  in  the  time 
domain  by  the  average  of  the  waveform  over  some  interval  [x  •  Apt  +  A].  This  can  be 
accomplished  by  defining  the  following: 


«4  =  int] 


where  int(jc)  is  the  integer  nearest  x. 
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Multiplying  a  data  series  by  Aimdl  will  return  a  smoothed  version  of  the  data  series. 
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E-4.2  Polynomial  Expansion 

E-4.2.1  Trigonometric  and  Exponential  Functions 

There  is  often  no  direct  way  of  evaluating  a  trigonometric  or  expontential  function 
of  a  polynomial  expansion.  Instead,  the  function  is  performed  on  a  data  series  converted 
from  the  argument  polynomial.  The  resulting  polynomial  is  then  reconverted  back  into  a 
polynomial. 

E-4.2.2  Integration  and  Differentiation 


Integrating  a  polynomial  Y  of  size  ny  results  in  another  polynomial  Z  of  size 
nz  =  ny  +  1.  The  nz  x  ny  integration  matrix  SDP  is  given  by: 


-1 

1 

0 


1 

2 

0 

1 

2 


0  0 


^DP  ~ 


0  0 


1  1 
3  4 

0  0 

0  0 


1 

3 


0 


o  4 


H)"y'1  (-l)v 

ny  - 1  ny 

0  0 


0  0 
0  0 


0  0  0  0 

0  0  0  0 

The  integral  is  evaluated  by: 


1 


0 


0 

1 


z  =  sx,,r+z0 


Of  course,  Z  may  be  converted  to  a  polynomial  of  a  different  size  if  desired. 

Differentiating  a  polynomial  Y  of  size  ny  results  in  another  polynomial  Z  of  size 
nz  =  ny- 1.  The  nz  x  ny  differentiation  matrix  ADP  is  given  by: 
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A-DP  - 


0  10  0 
0  0  2  0 
0  0  0  3 


0 

0 

0 


0 

0 

0 


0  0  0  0 
0  0  0  0 


ny~2 

0 


0 

ny~\ 


The  Differential  is  evaluated  by: 


z=V 


E-4.2.3  Switching  Functions 

Switching  functions  are  those  which  produce  a  Polynomial  waveform  Y  which  is 
composed  of  m  pieces  of  other  Polynomial  waveforms.  Let  fj  be  the  Polynmomial 
representation  of  the  yth  piece  of  Y.  Let  x0(f)  be  the  or  coordinate  of  the  ending  point  of 
the  /th  piece  where  x„(0)  =  -1  and  x„(m)  -  1, 

Define  Y,  to  be  the  Legendre  Series  representation  of  Y : 

r  r„l 


Y,= 


Then  using  the  orthogonality  property  of  the  Legendre  Series: 

*<><;> 


n  =  i  J  {~-\MMx)dx 
1  ' 


0-D' 

Now  define  the  following  row  vector: 

l(x0(j))  =  [L0(x0(J))  L,(j:o0'))  LMD)  ...  Ln.Mm  Ln(xoU))] 
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With  SDL  as  defined  in  section  E-4.3.2  and  A^)  as  defined  in  section  E-3.3.2  the 
solution  for  Y,  can  easily  be  found: 


yJ  =  £  mm)  -  K* oU  -  ms^A^G, 

im  i 

Now  we  need  only  convert  Y,  to  a  polynomial  exansion  Y: 

Y=AJ, 

where 


AL  =  [£<>(*)  Li(x)  Hx)  •••  ^-iCO] 

E-4.2.4  Waveform  Smoothing 

There  are  times  when  it  may  be  desirable  to  remove  high  spectral  content  features 
of  a  waveform.  One  way  to  do  this  is  to  replace  the  value  at  each  point  in  the  time 
domain  by  the  average  of  the  waveform  over  some  interval  [x  -  A,x  +  A],  This  can  be 
expressed  by  the  following  integral: 


x  4  A 


Wjxi~ldx 


The  only  problem  with  the  above  equation  is  near  the  boundaries  x  =  *1  and  x  =  1 
where  the  integration  interval  has  the  possibility  of  crossing  the  boundaries  and  including 
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within  the  average  a  section  of  the  polynomial  outside  the  defining  interval  [-1,1].  Hence 
the  smoothed  polynomial  should  be  composed  of  the  following  three  segments  (assuming 
A<  1): 

-1  <x<-l+A 


x  +  A 

iy/’  =  — ~  f  tWji-'dx 

,-l  “  X+A+l  J  j  ml  1 
-1 


-1  +  A <*  <  1  -A 


x  +  A 

iv'‘4  [  iwj-'ix 

im  l  2  A  J  j  ml 

ji-A 


1  —  A  <  j:  <  1 


,.i  1  -x  +A  J  ;-i  ; 

x-A 


Note,  if  1  <  A  <  2  then  the  interval  boundaries  are  given  by: 

[-1  ,  1-A] 

[1  -A  ,  -1  +  A] 

[-1+A  ,  1] 


If  A  >  2  then  there  is  only  one  interval  and  the  average  of  the  waveform  is  returned: 

i 

r.-jf  i 

y,.  =  0  for  i>1 


For  A  <  2  evaluating  the  integrals  require  the  definition  of  shifting  a  waveform  left 
or  right  by  A.  This  can  be  done  by  constructing  the  following  binonomial  matrix: 
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B 


exp 


1 

0 

0 

0 

0 


1 

1 

0 

0 

0 


1  1  1 
2  3  4 
1  3  6 
0  1  4 
0  0  1 


This  matrix  can  be  generated  by  the  following  recursion  formula; 

*«p(W)=i 
5exp(2:«,l)  =  0 

BCXf(i,j)  =  Bexp(i,j  - 1  )+Bexp(i  - 1  ,j  -  1) 


Multiplying  Bnft  element  by  element  by  the  following  matrix  BL  will  give  us  the 
transformation  matrix  Bthft  for  shifting  a  waveform  left  by  A. 


1  A 
0  1 
0  0 


A2  A3  A4 
A  A2  A3 
1  A  A2 
0  1  A 

0  0  1 


I 


i-l 


=  i  nxx+at' 


M  =BshfiN 


The  tools  are  now  aU  present.  W  can  be  integrated  using  the  integration  matrix  SDr 
defined  in  section  E-4.2.2.  The  limits  of  integration  for  the  three  segments  can  be  applied 
by  either  using  Bshft  for  the  limits  involving  x,  or  by  direct  evaluation  for  those  limits  not 
involving  x.  Dividing  by  the  averaging  interval  comes  next.  For  the  first  and  third 
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intervals,  the  methods  outlined  in  section  E-3.2.3  can  be  used  to  divide  a  polynomial  by 
another  polynomial.  Finally,  the  procedure  for  generating  Switching  Functions  described 
in  section  E-4.2.3  can  be  used  to  generate  the  coefficients  for  the  solution  Y. 
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E-4.3  Legendre  Series 

E-4.3.1  Trigonometric  and  Exponential  Functions 

There  is  often  no  direct  way  of  evaluating  a  trigonometric  or  expontential  function 
of  a  Legendre  Series.  Instead,  the  function  is  performed  on  a  data  series  converted  from 
the  argument  Legendre  Series.  The  resulting  polynomial  is  then  reconverted  back  into  a 
Legendre  Series. 

E-4.3.2  Integration  and  Differentiation 

Differentiating  a  Legendre  Series  can  be  done  easily  by  differentiating  the  recursion 
formula  for  the  Legendre  Series.  Recall: 

(i  +  l)L(l+1)CO  =  (2 1  + 1  )xL:(x)  - 


Differentiating: 


dL:  +  Xx) 

dx 


i  +  l 


dL,(x) 

dx 


+L,(x) 


'  i  VL, ■-,(*) 
^  i  + 1  )  dx 


where: 


dLxjx) 

dx 


=  0 


dLXx) 

dx 


=  1  =L0(x) 


The  goal  is  to  generate  the  following  «xn  matrix: 


A dl  — 


dU*)  dLjjx)  dLijx) 
dx  dx  dx 


dln  Ax)' 

dx 


The  columns  of  ADL  can  be  solved  recursively  once  we  define  the  matrix  for 
multiplying  a  Legendre  Series  Vector  by  x. 


i  +  l 
2i  + 1 
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0 

1 


1 

3 

0 


0 

0 


2 

3 

0 


Ac.  ~ 


0  0 


0  0 
0  0 
0  0 


0 


0 


0  0  0  0 
0  0  0  0 
0  0  0  0 


2(n  -  2)  + 1 

o  "-1 

2(n  - 1)  + 1 
0 

2(n  -  2)  + 1 


Note  that  the  last  row  of  AIL  has  been  elminated  to  make  the  matrix  square.  This 
will  not  cause  any  problems  since  in  the  recursion  formula,  the  last  coefficient  of  the 
vector  multiplying  Aa  is  always  zero. 


Let  ADL(:j)  represent  the /th  column  otADL.  Let  /  be  the  n  x  n  identity  matrix.  The 
recursion  formula  states: 


AdiX'-i  1  +  2)  — 


r2A_ +1 
<i  +  l 


(AoA>z(:»  /  + 1  )  +  /(:,/  +  !))- 


\<i<n -2 


Once  Adl  is  constructed,  it  can  be  used  to  calculate  derivatives.  Let  W  and  Y  be 
vectors  of  Legendre  Series  coefficients  of  size  n.  Then  the  following  statements  are 
identical: 


Y 


dW_ 

dx 


y=adlw 


Of  course,  the  nth  coefficient  of  Y  will  always  be  zero  since  the  nth  row  (as  well  as 
the  first  column)  of  ADL  will  always  be  populated  with  zeros. 
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Integration  is  a  bit  more  complex.  In  general,  the  problem  is  to  solve  the  following 
equation: 


^  =  ^0  + 


X 

J 


Wdx 


First,  the  n+1  x  ij  indefinite  integral  matrix  Sa  should  be  found.  The  easiest  way  of 
generating  Stt  begins  by  adding  an  additional  column  to  ADL  using  the  same  recursion 
formula  to  form  the  n  x  n+1  matrix  ADU.  S is  simply  the  pseudo-inverse  of  ADU: 


Sil  ~  (aduadu)  adu 


The  next  step  is  to  evaluate  the  integral  at  x  =  -1.  This  can  be  done  by  multplying 
the  following  row  vector  by  Stt: 

X,  =  [l  -1  1  -1  ...  (-I)"’1] 

s_i=x_lsIL 

The  first  row  of  SIL  contains  all  zeros.  If  this  row  is  replaced  by  -S.j  and  the 
resulting  matrix  called  ^DLi  we  have  all  the  pieces  for  calculating  the  integral  of  a 
Legendre  Series: 

Y  =  SdlW  +  Y0 

Of  course,  the  vector  Y  may  have  to  be  truncated  or  padded  with  zeros  as  required. 

E-4.3.3  Switching  Functions 

Switching  functions  are  those  which  produce  a  Legendre  Series  waveform  Y  which 
is  composed  of  m  pieces  of  other  Legendre  Series  waveforms.  Let  fj  be  the  legendre 
series  representation  of  the  /th  piece  of  Y.  Let  x0(j)  be  the  x  coordinate  of  the  ending 
point  of  the  /th  piece  where  xc(0)  =  -1  and  x0(m)  =  1. 

Let: 
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Then  using  the  orthogonality  property  of  the  Legendre  Series: 


*oO-i> 


2/-1 

2 


'jWL^dx 


Now  define  the  following  row  vector: 


/  C*o0 ))  =  VMV))  Li<*m  i4Mi) 


^-|W/))  Ln(x0(j))] 


With  SDL  as  defined  in  section  E-4.3.2  and  Am„()  as  defined  in  section  E-3.3.2  the 
solution  for  Y  can  easily  be  found: 


yt  =  £  (/(*,(/))  -  KxJJ  - 1 

j- i 

E-4.3.4  Waveform  Smoothing 

There  is  no  obvious  method  for  performing  waveform  smoothing  in  the  Legendre 
Series  spectral  domain.  Instead,  the  waveform  should  be  converted  to  a  polynomial 
expansion  and  the  methods  of  section  E-4.2.4  employed. 
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E-4.4  Chebyshev  Series 

E-4.4.1  Trigonometric  and  Exponential  Functions 


There  is  often  no  direct  way  of  evaluating  a  trigonometric  or  expontential  function 
of  a  Chebyshev  Series.  Instead,  the  function  is  performed  on  a  data  series  converted  from 
the  argument  Chebyshev  Series.  The  resulting  polynomial  is  then  reconverted  back  into  a 
Chebyshev  Series. 

E-4.4.2  Integration  and  Differentiation 


Differentiating  a  Chebyshev  Series  can  be  done  easily  by  differentiating  the 
recursion  formula  for  the  Chebyshev  Polynomials.  Recall: 

Ti  +  l(x)  =  2xTi(x)-Ti_l(x) 


Differentiating: 


dT^Qc) 

dx 


=  2x 


dTXx) 

dx 


+  2T(x) 


dT,_  ,(x) 


dx 


where 


dT0{x) 

dx 

dTt{x) 

dx 


The  goal  is  to  generate  the  following  nxn  matrix: 

_T  dT0(x)  dT^x)  dT 2(x)  dT„_  ,(*)' 

DT  dx  dx  dx  dx 

The  columns  of  ADT  can  be  solved  recursively  once  we  define  matrix  A ^  for 
multiplying  a  Chebyshev  Series  vector  by  x. 

XT'(X)  =  ~  (T;  _,(x)  +  T;  +  ,(*)) 
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0^00 

2 

10^0 

2 

0  r  0  z 


..0  0 


0  0 


0  0 


0  0^0 
2 


^xr  - 


..0  0 


0  0  0  0. 


•  2  0 


0  0  0  0.. 


0  0  0  0 


• 0 1 
■  i  » 


Note  that  the  last  row  of  AXT  has  been  eliminated  to  make  the  matrix  square.  This 
will  not  cause  any  problems  since  in  the  recursion  formula  which  follows,  the  last 
coefficient  of  the  vector  multiplying  A„  is  always  zero. 

Let  AD1i'-j)  represent  the  /the  column  of  ADT.  Let  /  be  the  n  x  n  identity  matrix. 
The  recursion  formula  states: 

i  +  2)  =  2AxrADj(\,  /  +  1)  +  2/(:,  /  +  1)  —  ADT(:,  i) 
i <i <n -2 

Once  Adt  has  been  constructed,  it  can  be  used  to  calculate  derivatives.  Let  W  and  Y 
be  vectors  of  Chebyshev  Series  coefficient  of  size  n.  Then  the  following  statements  are 
identical: 

Y  =  — 
dx 

Y=AnrW 


Of  course  the  nth  coefficient  of  Y  will  always  be  zero  since  the  nth  row  (as  well  as 
the  first  column)  of  ADT  will  always  be  populated  with  zeros. 
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Integration  is  a  bit  more  complex.  In  general,  the  problem  is  to  solve  the  following 
equation: 

x 

Y  =  Y0  +  J  Wdx 

Xm-\ 

First,  the  n+ 1  x  n  indefinite  integral  matrix  Sn  should  be  found.  The  easiest  way  of 
generating  Sn  begins  by  adding  an  additional  column  to  ADT  using  the  same  recursion 
formula  to  form  the  n  x  n+ 1  matrix  ADT1.  Sn  is  simply  the  pseudo-inverse  of  ADT1: 

$rr  ~  (ADtiAdt1)  ADTI 

The  next  step  is  to  evaluate  the  integral  at  x  =  -1.  This  can  be  done  t  nultplying 
the  following  row  vector  by  SlL: 

X_,  =  [l  -1  1  -1  ...  (-I)"-'] 


5_i  -  X_xSn 


The  first  row  of  Sn  contains  all  zeros.  If  this  row  is  replaced  by  -S.j  and  the 
resulting  matrix  called  $dt >  we  have  all  the  pieces  for  calculating  the  integral  of  a 
Chebyshev  Series: 

Y  =  SdtW  +  Y0 


Of  course,  the  vector  Y  may  have  to  be  truncated  or  padded  with  zeros  as  required. 

E-4.4.3  Switching  Functions 

Switching  functions  for  Chebyshev  Series  can  not  be  evaluated  as  easily  as  the 
switching  functions  for  Legendre  Series  due  to  the  weighting  function  r(x)  for  the 
Chebyshev  Polynomials.  Recall: 


-  -I  f  /<*> 

'~k)  1  vn 


-dx 


--I' 

-1 


dx 


The  situation  is  not  hopeless  due  to  the  following  integral  equations: 
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sin_l(.r) 


(2m)! 

(m!)2 


H(r-l)!  j2r_,  |  sin-1^) 

2^  -2^+1  ^  j  i  22"1 


Jr2",+1  , -  BI 

4 ==dx  =  -yfIZ?l 

yl-  r2  '  “ 1 


(2r)!(m!)2 


(2m  +  l)!(r!)2 


Thus  if  ^  is  the  Chebyshev  Series  representation  of  the  /th  piece  of  Chebyshev 
Series  waveform  Y  and  x0(j)  is  the  x  coordinate  of  the  ending  point  of  the  yth  piece,  then 
we  can  state  the  following: 


x0(0)  =  -1 


x0(m)  =  l 


O0) 


=-i  f 

7ty- !  J 


^oO-D 


VT-x2 


dr 


The  process  should  now  be  clear: 

1.  Convert  ff  x)  to  a  polynomial  representation  fPJ{x) 
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2.  Multiply  fPJ(x)  by  the  polynomial  representation  for  T,{x)  and  call  the  resulting 

polynomial  f^x). 

3.  Use  the  above  integral  equations  to  evaluate  at  x  =  x0(f)  and  x  =  x0(j-\)  the 

integral  of fg(x)  term  by  term  to  form  the  yth  component  of  Yt  called  Yf. 

4.  Sum  up  Yjj  over  j  to  produce  Yt. 

While  the  above  process  will  produce  the  correct  values  for  Yh  the  following 
method  is  much  easier  to  calculate  and  produces  nearly  identical  results: 

1.  Convert  f}(x)  to  a  Legendre  Series  representation  fy(x) 

2.  Calculate  the  Legendre  Series  Representation  Y,  of  Y  with  the  methods  of  section 

E-4.3.3. 

3.  Convert  Y,  to  the  Chebyshev  Series  Representation  Y. 

E-4.4.4  Waveform  Smoothing 

There  is  no  obvious  method  for  performing  waveform  smoothing  in  the  Chebyshev 
Series  spectral  domain.  Instead,  the  waveform  should  be  converted  to  a  polynomial 
expansion  and  the  methods  of  section  E-4.2.4  employed. 
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Appendix  F:  Model  Development 

The  following  electrical  power  system  models  have  been  develped  in  support  of 
WAVESIM: 

Three  Phase  Synchronous  Generator 

Voltage  Regulator 

Prime  Mover 

Three  Phase  Switch 

Transmission  Line 

Constant  Impedance  Loads 

Reduction  Gear 

Propeller 

Ship  Dynamics 

Pulse  Generator 

Induction  Motor 
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F-l  3  Phase  Synchronous  Machine  Model 

Two  models  are  presented  for  simulating  a  three  phase  synchronous  model.  The  first 
expresses  the  voltages  and  currents  in  terms  of  a  rotating  reference  frame  (dqO)  rotating  at 
the  base  frequency.  This  model  is  suitable  for  studies  where  the  voltages  and  currents  are 
balanced,  nearly  sinusoidal,  and  near  the  base  frequency.  For  fast  transients  or  unbalanced 
operations,  the  actual  instantaneous  values  for  the  voltages  and  currents  should  be  used  (abc 
frame).  Both  models  are  very  similar  in  that  the  terminal  values  are  transformed  to  a 
rotating  reference  frame  alligned  with  the  rotor  of  the  machine  (Park’s  Transformation) 

F-l.l  DQO  Model 
Interface  Variables 


Terminal 


Potential  Variable  Flow  Variables  (KCL  Group)  Type 


Stator  Direct  VD  (import)  /D  (export)  (1)  Normal 

Stator  Quadrature  VQ  (import)  /Q  (export)  (1)  Normal 

Stator  Zero  Sequence  V0  (import)  70  (export)  (1)  Normal 

Mechanical  com  (import)  Tm  (export)  (0)  Normal 

Field  Voltage  Vm  (import)  Information 

Stator  D-axis  Current  ^DI  (export)  Information 

Stator  Q-axis  Current  /Q,  (export)  Information 

Stator  0-axis  Current  hi  (export)  Information 

Field  Current  Ifi  (export)  Information 

The  import  and  export  xezp  vectors  are  defined  by: 
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Parameters 


xd  Synchronous  Reactance  (PU) 

xq  Negative  Sequence  Reactance  (PU) 

x/  Transient  Reactance  (PU) 

x /'  D-axis  Subtransient  Reactance  (PU) 

jr  "  Q-axis  Subtransient  Reactance  (PU) 

Xrf  Armature  Leakage  Reactance  (PU) 

Td:  Transient  Open  Circuit  Time  Constant  (seconds) 

Td0"  D-axis  Subtransient  OC  Time  Constant  (seconds) 

Tq"  Q-axis  Subtransient  OC  Time  Constant  (seconds) 

Armature  Time  Constant  (sec) 

H  Inertia  Constant  (sec) 

pr  Pole  Pairs 

ifnl  Field  Current  for  no  load  rated  voltage  (amps) 

(Ot,,  Base  System  Frequency  (rad/sec) 

0^  Base  System  Angle  (radians) 

VSB  Base  System  Voltage  (volts) 

P.Vfl  Base  System  Power  (watts) 

Vms  Base  Machine  Voltage  (volts) 

PMB  Base  Machine  Power  (watts) 

States 

0S  rotor  angle  wrt  to  synchronous  frame  (rad) 

\| I#  D-axis  flux -linkage  (PU) 

Q-axis  flux -linkage  (PU) 

eqS"  Q-axis  voltage  behind  subtransient  reactance  (PU) 

e a"  D-axis  voltage  behind  subtransient  reactance  (PU) 

eqS'  Q-axis  voltage  behind  transient  reactance  (PU) 
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Equations 

Constant  Definitions 

Base  Quantities 


2  P  SB 

?SB 


3  Vr 


Ta  = 


SB 


(USB 


T  -  ^ m 

jmb 

j  'MB 


Tmb  ~ 


PpP  MB 


Xal ) 

P JLTD 

Vm  =~~ 

*  Im 


Other  Constants 


Xad~Xd-Xal 


*/  = 


xh 


x<i~xj 


rf= 


x/ 

do 


xu  = 


xh 


Xd~xd 


a  = 


xd~xd'' 

Xd'-x/' 


-271  - 


Angle  Calculations 

0  =  ~  ^n,Pp)dt  +  0S 

e=s(tota-tomPp)+eS0 

Ce  =  cos(0) 

Se  =  sin(0) 

Variable  Rotation  and  Scaling 

M 


v=RvV 
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Solving  the  electrical  dynamical  equations 

The  five  electrical  dynamical  equations  must  be  solved  simultaneously.  Since  the 
Integration  Matrix  and  Multiplication  Matrix  are  linear  matrices,  the  entire  problem 
becomes  a  linear  process.  Hence  the  system  of  equations  can  be  represented  by  a  matrix 
equation. 

First  define  the  integration  and  multiplication  matrices 

^ x(t)dt  =  Sx  +  xs  ;  S  e  9TX"  xs  e  91" 
xy=M(y) x  ;  Me9T*" 


Now  we  define  the  system  of  equations 
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a>hs  0  0  0 

0  cofcJ  0  0 

0  0  0  0 

0  0  0  0 

0  0  0  — 

rf 

7  0  0  0  0‘ 

0/000 
Bs=  0  0  /  0  0 

0  0  0  /0 
0  0  0  0  /_ 


*0  - 


b  =  Bvv+Bss0 
x  =A~lb 
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Calculating  Export  Variables 


First  the  currents  in  machine  reference  frame 


C  = 


V 

0 

0 

0 


0  - ; 


1_ 

x/ 


0 

0  - 


0 

0 

xu 


Xu(Xf  —  xu) 


0  0 

b  0 

0  0 

r, 

0 


xMf-Xu) 


i  =  Cx 


Now  the  currents  in  system  reference  frame 


^FD 


R,= 


~M(Ce) 

‘SB 

-7fW(Se) 

1 SB 


0 

0 


~M(Se)  0  0 

‘SB 

^M(Ce)  0  0 

‘SB 

0  ^  0 

‘SB 

0  0  1 
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Torque  Equation 


r*.=Vrf»f-v,c, 

_2HPpdum 

acc  ®bs  dt 


Structural  Jacobian 

The  structural  jacobian  for  the  DQO  model  is  given  by: 

~N  N  0  N  N~ 

N  N  0  N  N 

0  0  0  0  0 

JDS  =  N  N  0  N  N 

N  N  0  N  N 

N  N  0  N  N 

0  0  0  0  0 

Jacobian  Calculations 

Calculating  the  jacobian  of  the  export  variables  with  respect  to  the  import  variables 
is  straight  forward  with  the  exception  of  the  partials  with  respect  to  the  mechanical 
frequency.  First  of  all,  nothing  depends  on  Vo,  hence  all  of  its  partials  are  zero.  In  the 
following  derivations,  the  Device  Jacobian  is  partitioned  such  that  the  voltages  and 
currents  are  split  from  the  mechanical  speed  and  torque. 

It  =  R,CA~\ByRtV+Bss0) 

a/, 

-  =  R,CA-%Ry 
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Calculating  the  partials  with  respect  to  the  mechancial  frequency: 


where 


and 


A 


Ax  =  BvRvV  +Bss0 
9.x  9  A  9 Rv 

5 —  +  5 — x=Bv^ — F 

9com  9ojm  9com 


=M-‘ 


9o), 


B  ^LV-^-x 

"to.  3(0. 


^-  =  RJC-~  +  ^-Cx 
9com  9tom  9com 


/ 


dA_ 

9com 


'  0 

SP, 

0 

0 

0 


-Spp  0  0  O' 

0  0  0  0 

0  0  0  0 

0  0  0  0 

0  0  0  0 


90 

9oom 


=  ~Spp 


V$B 

77~M(Se)SPp 

V  MB 

V$B 

-~~M{Ce)SPp 


V, 


SB 


'MB 


V , 


SB 


M(Ce)SPp 

M(Se)SPp 


0  0 

0  0 


9  R 

Am 


1/ 


-j—M  (Se)SPp  ~Y~M(Ce)SPp  0  0 

lSB  ‘SB 

I  L/n  I  MR 

^7-=  ~M(Ce)SPp  ~—M(Se)Spp  0  0 

UUJm  i$B  ‘SB 


The  Torque  equation  Jacobians  are  given  by: 

^Tm  _  Ts b  ^cpu 

dV  ~~TUS~W 


di„  dij  ch|/„ 

MW  +  MO,)  £ -  -  MO,)-^ 


^=1'  0  0  0  °ll 

IN0  '  0  0  oil 

9/^  d/' 

— -  =  [/  0  0  Olv1 
dv  1  Jav 

3ia  3i, 

SiH0  '  0  <V 


Now  with  respect  to  the  mechanical  frequency: 

BTm  TSB(dTacc  dT^ 


d(Om  l  9(Om  d(Om 


dTacc_2HpPs 

a)b. 


3T  3/‘  3^,,  9>j  3v|t 
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f^  =  [/  0  0  0  0]Jt- 

9(Om  9(Om 


^•=[0  7  0  0  0]^- 

dcom  d(om 

fa  „  ~  ~  fa 


9(0„ 


fa 

d(Or 


=  [/  0  0  0] 


=  [0  /  0  0] 


9(0™ 

fa_ 

9(0™ 


Putting  the  Jacobian  all  together: 


’  9 ID 

9 ID 

0 

9 ID 

9/d  " 

dVD 

dVQ 

dVF 

9(om 

9 Iq 

9 Iq 

0 

9 Iq 

9/e 

9 VD 

dVQ 

dvF 

9com 

0 

0 

0 

0 

0 

9  Tm 

9  r„, 

0 

9  Tm 

9r„ 

dvD 

dvQ 

dvF 

9wm 

9 ID 

9 ID 

0 

dip 

9/c 

dvD 

dVQ 

9vv 

9(om 

9 Iq 

9 Iq 

0 

dIQ 

dIQ 

dVD 

dVQ 

dvF 

9(om 

0 

0 

0 

0 

0 
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F-1.2  ABC  Model 
Interface  Variables 


Terminal 


Potential  Variable  Flow  Variables  (KCL  Group)  Type 


Stator  Phase  A 

Stator  Phase  B 

Stator  Phase  C 

VK  (import) 

VB  (import) 

Vc  (import) 

7a  (export) 
7b  (export) 
7C  (export) 

Mechanical 

0)m  (import) 

Tm  (export) 

Field  Voltage 

Vfd  (import) 

Stator  Phase  A  Current 
Stator  Phase  B  Current 
Stator  Phase  C  Current 
Field  Current 

Iai  (export) 

7Bi  (export) 

7C j  (export) 

/F  (export) 

The  import  x ^  and  export  xexp  vectors  are  defined  by: 


(1)  Normal 
(1)  Normal 
(1)  Normal 

(0)  Normal 

Information 

Information 

Information 

Information 

Information 


imp 


Parameters 


All  Parameters  are  identical  to  the  DQO  Model 

States 

All  States  are  identical  to  the  DQO  Model 

Equations 

Constant  Definitions 

All  Constants  definitions  are  identical  to  the  DQO  Model 
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Angle  Calculations 

For  this  model,  the  angle  is  the  actual  rotor  angle  of  the  synchronous  machine: 

®  =  Jawyft+©» 

0  =  5  (s)mpp  +  0^0 

Note:  When  calculating  QS]  it  would  be  wise  to  limit  its  range  to  ±k. 

Variable  Rotation  and  Scaling 

To  convert  from  the  V  vector  to  the  v  vector.  Parks  transformation  should  be  used: 


v  =  RvV 


Solving  the  electrical  dynamical  equations 

The  electrical  dynamical  equations  are  solved  in  exacdy  the  same  way  as  for  the 
DQO  model. 
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Calculating  Explicit  Variables 


The  only  difference  for  calculating  the  explicit  variables  are  the  following 
matrices: 


M(cos(0)) 


0 


-M(sin(0)) 

J.(n  2*  Vi 

-Afj^sin^©-  — 


-Ml  s: 


in^0 


2k 
+  — 


JJ 


0 


1 

1 

1 

0 


0 

0 

0 

I  SB 

Im 


Structural  Jacobian 


The  structural  jacobian  for  the  ABC  model  is  given  by: 


~N 

N 

N 

N 

N~ 

N 

N 

N 

N 

N 

N 

N 

N 

N 

N 

N 

N 

N 

N 

N 

N 

N 

N 

N 

N 

N 

N 

N 

N 

N 

N 

N 

N 

N 

N 

Jacobian  Calculations 


The  only  differences  for  calculating  the  jacobian  matrices  are  the  following: 


90 

9com 


=  SPp 
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dRv  _  2Vsb 

d(i>m  3Vm 


-M  (sin(0))S  pp 

-M(cos(0))Spp 

0 

0 


-M 

-M\ 


(  f 

sin 

l 

f 


( 


cos 


0  + 
0  + 


V 


2k 

T 

2k 

T 


o 

o 


dRj 

Iw 

d(om 

I SB 

-M  (sin(©))5  pp 


-M  sid 


/ 

2k 


-M(cos(Q))Sp 
(  f 


-M 


cos 


-M|  sin|  Q+—  jjSpp 
0 


-  M  coa 


_  2n^ 
@~~3  J 
_  2;c^ 

®+T 

0 


0 


Pp  0 


0 


O' 

0 

0 

0 


Putting  the  Jacobian  all  together: 


'd/a 

a/a 

a/a 

a/a 

dIA  I 

dVA 

dVg 

dvc 

dvF 

a©m 

dig 

dig 

dig 

dig 

a/* 

WA 

Wg 

Wc 

WF 

a®m 

dlc 

die 

dlc 

dic 

a/c 

WA 

Wg 

Wc 

dVF 

a©m 

dTm 

dTm 

dTm 

drm 

a^. 

dvA 

dVB 

dvc 

dvF 

a® u 

a/a 

a/a 

a/a 

a/a 

a^ 

dVA 

dVg 

dvc 

dVF 

aw„ 

dig 

dig 

dig 

dig 

dig 

WA 

Wg 

Wc 

dvF 

dwm 

dlc 

dlc 

die 

dlc 

dlc 

WA 

dVg 

Wc 

dvF 

d(Om 
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F-2  Voltage  Regulator  Model 


This  is  a  simple  voltage  regulator  model.  The  voltage  regulator  is  assumed  to  be  of  a 
PI  type  controller.  This  design  does  not  have  any  clipping  on  the  output  waveform  to 
ensure  the  field  voltage  is  kept  within  a  reasonable  range.  This  model  is  intended  for  single 
generator  operation  since  it  has  no  provision  for  reactive  power  sharing  with  paralleled 
generators. 

F-2.1  DQO  Model 
Interface  Variables 


Terminal 


Potential  Variable  Flow  Variables  Type 


Line  Direct  Voltage 
Line  Quadrature  Voltage 
Reference  Voltage 
Field  Voltage 


VD  (import) 
Vq  (import) 
(import) 
VFD  (export) 


The  import  x ^  and  export  xtxp  vectors  are  defined  by: 


Information 

Information 

Information 

Information 


Parameters 


k, 

Integrating  factor  (1  /  sec) 

kP 

Proportional  factor  (PU) 

koQo 

Voltage  Magnitude  Conversion  factor  (PU) 

States 

Field  Voltage 

Equations 

Calculate  the  terminal  voltage: 

*,,  =  <wViVVV'V 

Calculate  the  error  voltage: 

V~  =  V^-V, 


-284- 


Calculate  the  Field  Voltage: 


Va  =  jk,V„dt  +  kpV„  +  VldS 

Structural  Jacobian 

The  structural  jacobian  for  the  DQO  model  is  given  by: 

Jds  =  [N  N  L] 

Jacobian 


dVpp 

dV, 


=  -k,S-kpI 


dVnJVfodV, 

dVD  ~  dv,  dVD 

dVFD  =  dVFDdV, 
dVQ  "  dV,  dVQ 

Note  the  partials  of  V,  with  respect  to  VD  and  VQ  must  be  determined  from  the  square  root 
function: 

dVL_  Vo 
dvD  DQ0  V, 


The  device  jacobian  is  given  by: 

.  dVFD  dV/rp  dV FD 

°~[dvD  dvQ  dvref 
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F-2.2  ABC  Model 
Interface  Variables 


Terminal 


Potential  Variable  Flow  Variables  Type 


Phase  A  Voltage 
Phase  B  Voltage 
Phase  C  Voltage 
Reference  Voltage 
Field  Voltage 


VA  (import) 
VB  (import) 
Vc  (inport) 
(import) 
VFD  (export) 


Information 

Information 

Information 

Information 

Information 


The  import  x ^  and  export  xexp  vectors  are  given  by: 


Parameters 


ximn 

imp 


yB 

Vc 


xap  =  [VFD] 


ki 

Integrating  factor  (1  /  sec) 

kP 

Proportional  factor  (PU) 

kA.BC 

States 

Voltage  Magnitude  conversion  factor  (PU) 

Field  Voltage 

Equations 

Calculate  and  subtract  out  the  DC  offset  of  the  common  potential: 

0_  3 

V BO  ~Vg-V0 

VC0  =  Vc-V o 
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Calculate  the  Terminal  voltage1: 


v,  —  ^ AD  '  VaO  +  VbO  '  VbO  +  Vco  '  Vco) 


Calculate  the  Error  voltage: 


Calculate  the  Field  Voltage: 


V^V^-V, 


=  J  k,v„dt 


+krv„+v,<s 


Note  1:  Derivation  of  Terminal  Voltage: 


Assume  phase  voltages  are  balanced  three  phase: 

Vao  =  VVcos(0) 


vbo  =  v'j-cosfe+y 

Vco  =  VrCosf0-y 


^  +  ^  +  V^  =  ^(l+cos(20)  + 

1  +  cos(20)  cos^  y  j  -  sin(20)  sin^  y  - 
1  +  cos(20)  cos  y  +  sin(20)  sinl  y  J 


y2  +  y2  +  y2  =-V2 
v ao  ^  v bo  ^  v co  2  Vt 


Structural  Jacobian 


The  structural  jacobian  for  the  ABC  model  is  given  by: 


Jds  =  [N  N  N  L] 
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Jacobian 


dvFD 

dVref~ 

y+y 

dVpp 

dV,  “ 

-y  ■ 

-v 

3Vfd 

ay, 

dVA  ~ 

3V, 

ay* 

aVfD 

dVj® 

ay, 

avfi  ~ 

ay, 

dVB 

ay«>_ 

avro 

dV, 

3KC 

ay, 

BVC 

Note  the  partials  of  V,  with  respect  to  VA,  VB ,  and  Vc  must  be  determined  from  the  square 
root  function: 

vj, 

dVM  ^  V , 

dV>  _  t  v» 

dVB0  W, 

dV'  _  k  Vco 
dVC0  V, 


dV, 

2  dV, 

i  ay, 

i  ay, 

dVA  = 

'3dVM 

3av/fi0 

3ayco 

dy,_ 

1  dV, 

2  a^ 

.  i 

i  ay, 

dvB 

i 

OJ  I 
QJ 

3  ay*, 

3ayco 

dv,_ 

1  BV, 

i  ay, 

2  ay, 

dvc 

3dVM 

3  ay*, 

j 

3  BVC0 

-  288  - 


The  device  jacobian  is  given  by: 


dVFD 

dV fd 

dVFD 

Wa 

dvB 

dvc 

dVrrf 
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F-3  Prime  Mover 

This  is  a  rather  crude  model  of  a  PI  controller  on  a  prime  mover.  The  dynamics  of  the 
controller  are  assumed  to  dominate  the  response  of  the  prime  mover. 

Interface  Variables 


Terminal 

Mechanical 


Potential  Variable  Flow  Variables  (KCL  Group)  Type 
(0m  (import)  Tm  (export)  (0)  Normal 


Information  (£>rtf  (import) 

The  import  x -  and  export  xtxp  vectors  are  defined  by: 


Information 


xmp  = 


co„ 


co, 


r*f 


Xap  =  [TJ 


Parameters 


k,  Integrating  Torque  factor  (1  /  sec) 

kP  Proportional  Torque  factor  (PU) 

(Dfej  base  frequency  (rad/sec) 

PSB  base  System  Power  (watts) 

PMB  base  Machine  Power  (watts) 

States 

T,^  mechanical  torque 

Equations 


T  = 


MB 


SB 


c Obs 


+  T. 


mS 


Structural  Jacobian 

The  structural  jacobian  for  the  Prime  Mover  model  is  given  by: 

Jds  =  [L  L] 
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Jacobian 


dT„  _  Pm  Ic  ^ 


3cor, 

- — s 

i  P  SB  ®bs 

dTm_ 

d(0m 

M<f 

arm  I 

— 

D  ~~ 

F-4  Three  Phase  Switch 


F-4.1  DQO  Model 


Interface  Variables 


Terminal 


Potential  Variable  Flow  Variables  (KCL  Group)  Type 


TD1 

TQ1 

T01 

TD2 

TQ2 

T02 

SW 


VD1  (Import) 
VQI  (Import) 
V0I  (Import) 
VD2  (Import) 
VQ2  (Import) 
V02  (Import) 

Sw  (Import) 


lm  (Export) 
IQJ  (Export) 
Iot  (Export) 
ID2  (Export) 
IQ2  (Export) 
I 02  (Export) 


(1)  Normal 

(2)  Normal 

(3)  Normal 

(1)  Normal 

(2)  Normal 

(3)  Normal 

Information 


All  Interface  variables  are  on  a  Per  Unit  (PU)  Basis 


The  import  and  export  xtxp  vectors  are  given  by: 


- 1 

•*» 

_ 1 

4>; 

Vv 

lQl 

VOl 

4. 

X  = 

VD2 

**p 

4)2 

Vv 

Iq2 

1 

- 1 

./« 
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Parameters 


Gom  On  Conductance  (PU) 

Goff  Off  Conductance  (PU) 

States 

There  are  no  states  for  this  model. 

Equations 

The  equations  for  the  switch  are  very  simple.  First,  we  define  the  conductance  G  of 
the  waveform: 


If 

o 

A 

* 

CO 

Then 

G=Gon 

Else 

G=G°ff 

Now  Generate  the  Conductance  Matrix  GD : 


M(G) 

0 

0 

Mi-G) 

0 

G 

O' 

0 

M(G) 

0 

0 

Mi-G) 

0 

0 

0 

0 

M{G) 

0 

0 

Mi-G) 

0 

M(-G) 

0 

0 

MiG) 

0 

0 

0 

0 

Mi-G) 

0 

0 

MiG) 

0 

0 

0 

0 

Mi-G ) 

0 

0 

MiG) 

0 

The  export  variables  are  simply: 

xap  = 


Structural  Jacobian 

The  structural  jacobian  is  given  by: 
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^DS  ~ 


N  0  0  N  0  0  N' 
0  N  0  0  N  0  N 
0  0  N  0  0  N  N 
N  0  0  N  0  0  N 
0  N  0  0  N  0  N 
0  0  N  0  0  N  N 


Jacobian  Calculations 

The  jacobian  matrix  is  very  similar  to  GD: 

M(G)  0  0 

0  M(G)  0  0 

0  0  M(G)  0 

M(-G)  0  0  M(G)  0 

0  M(-G)  0  0  M(G) 

0  0  M(-G)  0 


Jn  = 


dG ' 

M(-G)  0  0  M^Voi-vo2)^ 

dG 

M(-G)  0  M(VQ]-vQ2)^r 

dG 

0  M(~G) 


0  M{VD2-VDI) 


9G 

dSw 


dG 

0  Wv-Vw)Ww 

0  M(G )  Af(V„-F0,)^- 


dC  ^  9 

Where  r—  is  determined  by  the  If-Then-Else  function. 


as, 
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F-4.2  ABC  Model 


Interface  Variables 


Terminal  Potential  Variable  Flow  Variables  (KCL  Group)  Type 


TA1 

TB1 

TCI 

TA2 

TB2 

TC2 

SW 


VM  (Import) 
VBJ  (Import) 
VCi  (Import) 
(Imoort) 
VB2  (Import) 
VC2  (Import) 

Sw  (Import) 


Iaj  (Export) 
hi  (Export) 
ICI  (Export) 
Ia2  (Export) 
IB2  (Export) 
IC2  (Export) 


(1)  Normal 

(2)  Normal 

(3)  Normal 

(1)  Normal 

(2)  Normal 

(3)  Normal 

Information 


The  import  x ^  and  export  xexp  vectors  are  given  by: 


r 

1 _ 

' Iai ' 

yu 

hi 

Va 

X  = 

hi 

exp 

I* 

VB2 

hi 

1 

_ 1 

Jc2m 

Parameters 


Gm  On  Conductance  (PU) 

Goff  Off  Conductance  (PU) 

States 


There  are  no  states  for  this  model. 


Equations 
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The  equations  for  the  switch  are  very  simple.  First,  we  define  the  conductance  G  of 
the  waveform: 


If 

Sw>  0 

Then 

G=Gon 

Else 

G 

Now  Generate  the  Conductance  Matrix  GD : 


'  M(G) 

0 

0 

M(-G) 

0 

0 

O' 

0 

M(G) 

0 

0 

M(~G) 

0 

0 

0 

0 

M(G) 

0 

0 

M(-G) 

0 

M(-G) 

0 

0 

M(G) 

0 

0 

0 

0 

M(-G) 

0 

0 

M(G ) 

0 

0 

0 

0 

M(rG) 

0 

0 

M(G) 

0 

The  export  variables  are  simply: 

*exp  ~  GD*imp 


Structural  Jacobian 

'N  0  0  N  0  0  AT 

0  N  0  0  N  0  N 

00N0  0NN 
05  ~  N  0  0  N  0  0  N 

0  N  0  0  N  0  N 

0  0  N  0  0  N  N 
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Jacobian  Calculations 


The  jacobian  matrix  is  very  similar  to  GD: 


M(G )  0  0  M(-G)  0  0  MiV^-Vu) 

0  M(G)  0  0  M(-G)  0  M(VB1-VB2) 


0  0 


4  = 


M(-G )  0 


MiG)  0  0  M(-G)  M(VC1-VC2 ) 

0  MiG)  0  0  MiV^-Vu) 


0  Mi-G)  0  0  MiG)  0  MiVB2-  VB1) 


0  0  Mi-G)  0 


0 


MiG) 


MiVC2-Va) 


Where  rr-  is  determined  by  the  If-Then-Else  function. 

<*>W 
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F-5  Transmission  Line 


DQO  Model 

Interface  Variables 


Terminal 


Potential  Variable  Flow  Variables  (KCL  Group)  Type 


td1 

VDl  (Import) 

IDI  (Export) 

tq1 

Vqi  (Import) 

lot  (Export) 

T01 

Voi  (Import) 

hi  (Export) 

Tm 

VD2  (Import) 

ID2  (Export) 

Tq2 

Vq2  (Import) 

Ig2  (Export) 

To2 

Voi  (Import) 

l02  (Export) 

The  import  x ^  and  export  xtxp  vectors  are  given  by: 


(1)  Normal 

(2)  Normal 

(3)  Normal 

(1)  Normal 

(2)  Normal 

(3)  Normal 


~v« 

Idi 

Vqi 

Iqi 

vm 

4, 

X  = 

vD2 

**p 

4>: 

VQ2 

Iq2 

1 - 

./« 

Parameters 

R  Resistance  (ohms) 

X  Reactance  (ohms) 

States 


(There  are  no  states  for  this  model) 


Equations 

Constant  Definitions 


G  = 


Y  —  - 


X2+R2 
X 


x2+r2 
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Calculate  the  Export  Variables 


Structural  Jacobian 

The  Structural  Jacobian  is  given  by: 

~D  D  0  D  D  O' 
D  D  0  D  D  0 
0  0  D  0  0  D 

Jps~  D  D  ODD  0 
D  D  ODD  0 
0  0  D  0  0  D 

Jacobian  Calculations 

The  matrix  JD  is  the  Jacobian  matrix. 
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ABC  Model 

Interface  Variables 


Terminal 

Potential  Variable 

Flow  Variables 

(KCL  Group)  Type 

ta1 

VM  (Import) 

Iai  (Export) 

(1)  Normal 

Tb, 

VBt  (Import) 

hi  (Export) 

(2)  Normal 

Tc, 

VCI  (Import) 

hi  (Export) 

(3)  Normal 

Ta2 

Vai  (Import) 

7x2  (Export) 

(1)  Normal 

^82 

Vjt,  (Import) 

IB2  (Export) 

(2)  Normal 

Tc2 

VC2  (Import) 

hi  (Export) 

(3)  Normal 

The  import 

ximP  export  xezp  vectors  are 

given  by: 

- 1 

_ 1 

'h' 

vu 

hi 

Va 

x  = 

hi 

Ku 

exp 

h 

vB2 

hi 

_ 1 

1 

Q- 
\ _ 

Parameters 


R  Series  Resistance  (ohms) 

G  Parallel  Conductance  (mhos) 

L  Inductance  (henries) 

States 


^AL  Phase  A  Inductor  Current 

hi  Phase  B  Inductor  Current 

hi  Phase  C  Inductor  Current 

Equations 


Each  of  the  three  phases  can  be  treated  independently  of  one  another.  In  the 


equations  which  follow  replace  a  subscripted  X  with  the  appropriate  phase  letter: 


First  write  the  equations  describing  the  phase: 


'  R 
1 


-H 


lXl 


'XN 


-I 


0  G  +- 


0 

-7 


xi 


'  X2 


‘ XU) 


=  0 
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Manipulating  the  first  matrix  equation,  we  can  get  an  expression  for  the  terminal  1 
current: 

-(H  '] 

Kj a 

4;  =  G.v  Vx2 

JxLO 

Once  this  is  known,  the  other  variables  are  easy  to  calculate: 

Vxn  ~  Vxi  ~  r^xj 
( I  \  VX1 

1XL-~  ^XN  +  ~n~  +  G  ^X2 

\R  J  R 


Structural  Jacobian 

The  Stmctural  Jacobian  is  given  by: 

'L  0  0  L  0  O' 
0  L  0  0  L  0 

00L00L 
DS  ~  L  0  0  L  0  0 

0  L  0  0  L  0 

0  0  L  0  0  L 
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Jacobian  Calculations 

The  Jacobian  Matrix  can  be  directly  constructed  from  the  first  element  of  G 

(d  Y(S  \ 

Gn  =  —  S  +RG  +/  —  +  G 

\L  )  \L  J 

Gn  0  0  -Gn  0  0 

0  Gu  0  0  —  G,,  0 

0  0  Gn  0  0  —  Gu 

-Gu  0  0  Gu  0  0 

0  ~GU  0  0  Gn  0 

0  0  —  G,,  0  0  Gn 
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F-6  Constant  Impedance  Loads 
DQO  Model 
Interface  Variables 

(KCL  Group)  Type 

(0)  Normal 
(0)  Normal 
(0)  Normal 


Terminal 


Potential  Variable  Flow  Variables 


VD  (import) 
Vq  (import) 
Vq  (import) 


ID  (export) 
IQ  (export) 
Iq  (export) 


The  import  x^.  and  export  xe  vectors  are  given  by: 


4> 

4 

Parameters 

R  Load  resistance  (ohms) 

X  Load  reactance  (ohms) 

GgnJ  Zero  Sequence  conductance  to  ground. 

States 


X  ~ 

v» 

VQ 

x  — 

imp 

exp 

1 

_ 1 

(There  are  no  states  for  this  model) 


Equations 

First  calculate  the  admitance 


G  = 


R 

R2  +  X2 


Y  =  - 


X 

r2+x2 


Now  calculate  the  Admitance  Matrix: 


G  ■  = 


G  -Y 
Y  G 
0  0 


0 

0 

Jgnd 


X-p  =  Gy>X<mp 
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Structural  Jacobian 


The  Structural  Jacobian  is  given  by: 


Jos  ~ 


D  D  0 
D  D  0 
0  0  D 


Jacobian  Calculations 

The  jacobian  matrix  is  the  G„  matrix. 
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ABC  Model 


Interface  Variables 


Terminal 


Potential  Variable  Flow  Variables  (KCL  Group)  Type 


VA  (import) 
VB  (import) 
Vc  (import) 


IA  (export) 
IB  (export) 
Ic  (export) 


The  import  x-  and  export  x  vectors  are  given  by: 


Parameters 


States 


Series  Resistance  (ohms) 

Parallel  Conductance  (mhos) 
Inductance  (henries) 

Resistance  of  center  to  Ground  (ohms) 


Phase  A  Inductor  Current 
Phase  B  Inductor  Current 
Phase  C  Inductor  Current 


(0)  Normal 
(0)  Normal 
(0)  Normal 


Equations 

This  load  model  can  be  considered  to  be  a  transmission  line  where  all  the  terminals  of  one 
side  are  connected  together  to  a  resistor  going  to  ground.  As  such,  we  can  use  some  of 
the  derivations  from  the  transmission  line  model: 


C?3f  =1  +/?G  +/ 


G\i  =  Gn\j£  +  G 


G\]VX2+G]JIXL0 


Kx2  _  (I A  h  +  Ic^GND 
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This  can  be  rewritten  by  defining  the  following  matrix: 


(J  +^GWD^ll)  RgNdG  11  ^CND^U 

G^C  =  RgNdG  II  +RgNdGh)  RgM>Gu 

R-GNdG  11  RcND^M  if  +^A©^ll)j 

Which  allows  the  following  equation  to  be  written: 

4' r gu  o  oirv^l  \g»  o  oir im' 

Gabc  4  =  o  <4,  o  14+0  g3,  0  iBU) 

Ic  0  0  Gjj  Vc  0  0  G31  4xo 


Or  if  we  rewrite  the  equation: 

'41  \Gn  0  Oir^-i  rG31  0  oirw 

4  -G^c  0  G„  0  V,  +  GyJc  0  G3,  0  IBlD 

4J  [00  GuJ[vcJ  [0  0  G31J[/clo 


The  inductor  current  for  phase  X  can  be  determined  from: 

Vm  =  Vx-RIx 

IxL=-\^  +  G^jVXN+-^  +  GRGM}iIA+IB+Ic) 


Structural  Jacobian 

The  structural  jacobian  is  given  by: 

'L  L  L 
JDS  —  L  L  L 
L  L  L 


-305- 


Jacobian  Calculations 

The  Jacobian  Matrix  is  given  by: 

'Gu  0  0  ' 

Jd  =  Gmc  0  Gn  0 
0  0  Gn 
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F-7  Reduction  Gear 


Interface  Variables 

Terminal  Potential  Variable  Flow  Variables  (KCL  Group)  Type 

51  co,  (export)  Tj  (export)  (0)  Normal 

52  0)2  (import)  T2  (import)  (0)  Normal 

The  potential  variables  are  measured  in  radians/second  while  the  flow  variables  are 
measured  in  Newton-meters. 

The  import  x ^  and  export  xexp  vectors  are  given  by: 


Parameters 

nl  Number  of  teeth  on  shaft  1. 

n2  Number  of  teeth  on  shaft  2. 

T|  Efficiency  of  Reduction  Gears. 

States 

There  are  no  states  for  this  model. 

Equations 

The  rotational  speed  of  the  shafts  are  proportional  to  the  gear  ratio: 

fh 
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The  transmitted  torque  however,  must  be  scaled  by  the  efficiency.  Which  side  of  the 
equation  the  efficiency  applies  depends  on  the  direction  of  the  power  flow: 


if 

r2cq2>  0 

then 

it 

i 

3s  I-3 

j 

else 

rt, 

Ty  — - ~T2 

m 

The  first  zero  crossing  of  the  power  should  be  passed  back  to  the  system  as  a 
suggested  recalculation  time. 

Structural  Jacobian 

The  structural  jacobian  is  given  by: 

j  J*  o] 

DS  [n  jvj 

Jacobian  Calculations 

The  jacobian  is  given  by: 

tU 

-  0 

J  =  Ul 
D  dT\  dTy 

StOj  dT2 

The  partials  of  T,  depend  on  the  partial  derivatives  of  the  if-then-else  function.  If 
the  direction  of  the  power  flow  remains  constant  over  the  interval,  then  the  partials  are 
given  by: 

ar, 

a^'° 

?h=h 

ar2  t2 
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F-8  Propeller 


The  relationship  between  the  torque,  angular  speed,  forward  velocity  and  forces  on  a 
propeller  are  highly  complex  and  nonlinear.  While  much  information  is  known  about  the 
steady-state  operation  of  propellers  traversing  in  the  forward  direction,  little  information  is 
available  for  nonstandard  operating  conditions.  The  classical  approach  is  to  generate  K,  vs  J 
and  Kq  vs  J  curves  where: 


F=KT(J)pD*n2 

Tm=KQ(J)pD5n2 

where  the  variables  are  described  in  the  following  sections. 

The  classical  approach  works  well  when  Vp  (speed  of  propeller  with  respect  to  the 
fluid)  and  n  (RPM  of  shaft)  are  both  positive  and  n  is  large  enough  to  bring  J  (advance 
coefficient)  below  about  1.5.  Outside  of  this  range,  little  data  is  provided  for  most 
propellers.  The  classical  approach  breaks  down  completely  when  the  shaft  speed  is  zero 
and  J  is  infinite.  Furthennore,  there  is  no  way  to  differentiate  between  backing  down  (n 
and  Vp  both  negative)  and  having  forward  way  on  (n  and  Vp  both  positive).  The  method 
used  for  this  model  is  better  suited  for  simulation  studies  because  it  essentially  uses  the 
angle  of  attack  on  the  propeller  blade  as  the  argument  for  the  thrust  and  torque  coefficients. 
This  model  is  based  on  work  conducted  at  the  Naval  Ship  Research  and  Development 
Center,  Annapolis,  MD  by  D.  W.  Baker  and  C.  L.  Patterson  and  reflects  data  and  theory 
developed  by  I.  Ya.  Miniovich. 

Interface  Variables 

Terminal  Potential  Variable  Flow  Variables  (KCL  Group)  Type 

Mechanical  com  (import)  Tm  (export)  (0)  Normal 

Hydrodynamic  u  (import)  F  (export)  (0)  Normal 

Note:  units  are  radians! second.  Newton-meters,  meters! second,  and  Newtons 

The  Import  and  Export  Xtxf  vectors  are  defined  by: 
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Parameters 


D  Diameter  of  Prop  ( meters ) 

w  Wake  Fraction  (PU) 

p  Density  of  water  (kg/m3) 

Cj()  Thrust  Coefficient  matrix  (unlimited  rows  by  2  columns) 

first  column  is  0  in  radians  [-7t  7t] 
second  column  is  Thrust  Coefficient  in  PU. 

Ce()  Torque  Coefficient  matrix  (unlimitd  rows  by  2  columns) 

first  column  is  0  in  radians  [-ft  rt] 
second  column  is  Torque  Coefficient  in  PU. 

States 


(There  are  no  states  for  this  model) 


Equations 


Vp  =  (l-w)u 


0  =  a.tan2(nD,Vp) 

F  =  -CT(Q)pD2(V2  +  n2D2) 

Tm  =  CQ(Q)pD\V2p  +  n2D2) 

Normally,  CT ()  and  CQ()  are  specified  as  data  points.  Hence  some  type  of 
interpolations  scheme  is  needed  to  determine  the  value  of  theses  functions  at  intermediate 
points,  as  well  as  the  value  of  the  first  derivative. 

Device  Structural  Jacobian 

The  Device  Structural  Jacobian  for  all  waveforms  is  given  by: 
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Jacobian  Calculations 


V 

90 _ «2o 

Of  course,  the  partials  of  Cj<0)  and  Ce(0)  with  respect  to  0  must  be  determined 
from  the  interpolation  scheme  used. 

Putting  all  of  this  together: 

■d T.  *r± 

-  _  9(0,  9  u 

D~  9F  9F 

9o^  9  u 
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F-9  Ship  Dynamics  Model 
Interface  Variables 

Terminal  Potential  Variable  Flow  Variables  (KCL  Group)  Type 

Ship  Hydrodynamics  u  (import)  F  (export)  (0)  Normal 

Velocity  u  is  measured  in  meters/second  while  force  F  is  measured  in  Newtons. 
The  import  xmp  and  export  xtzp  vectors  are  given  by: 

X,mp  =  [*] 

Parameters 

p  Density  of  Salt  Water  (kg/m3)  1025.9  kg/m3  @  15“  C. 

v  Kinematic  Viscosity  of  Water  (m2/sec)  1.19xlO'*m2/sec@15“C. 

G  Acceleration  of  Gravity  (m/sec2)  9.80665  m/sec2 

L  Length  of  Ship  (m) 

As  Surface  Area  of  Ship  (m2) 

m  Mass  of  Ship  (kg) 

mo<u  Added  Mass  Multiplier  (PU)  (normally  between  1 .0  and  1.10) 

Ct  Correlation  Allowance 

CJ(R,)  Matrix  of  Frictional  Drag  Coefficients  (2xn)  or  (3 xn) 

column  1  are  Reynolds  Number  Values 
column  2  are  Frictional  Drag  Coefficient  Values 
column  3  are  optional  first  derivative  values  of  the  curve 
Note:  Values  should  be  provided  for  negative  Reynolds  Numbers 

Cr(Fr)  Matrix  of  Residual  Drag  Coefficients  (2 xn)  or  (3x/i) 
column  1  are  Froude  Number  Values 
column  2  are  Residual  Drag  Coefficient  Values 
column  3  are  optional  first  derivative  values  of  the  curve 
Note:  Values  should  be  provided  for  negative  Froude  Numbers 

States 

There  are  no  states  associated  with  this  device 
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Equations 


The  basic  equations  are  given  by: 


F  =-= 
r  <GL 

CT  -  Cf(Re)  +  Cr(Fr)  +  Ca 

_  p  2.  _  du 

F=-k  AsC7  +  m^m  — 

The  only  potential  difficulty  is  performing  the  evaluation  of  the  drag  coefficients 
Cj(Rt)  and  Cr(Fr). 

Structural  Jacobian 


The  structural  jacobian  is  given  by: 


jDS=m 


Jacobian  Calculations 


pf  (l  dCAR ,))  l  fdCr(Fr )))  } 

Jd  =  ^A,  M {u )M (u )  -M  +~r==M  —7=r~  +2 + 

2  1  lv  l  dK'  )  yjiG  l  dtr  \\  I 


maddrnS~ 

JCifi')  dC'lF r) 

where  S  is  the  integration  matrix  and  (-  d~)  must  be  determined  by  either 


differentiating  the  Cj(R,)  (Cr(Fr))  curve  or  by  interpolating  the  third  colum  if  so  provided. 
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F-10  Pulse  Generator 


Interface  Variables 

Terminal  Potential  Variable  Flow  Variables 

VO  V  (export) 

The  import  and  export  xexf  vectors  are  given  by: 

x,mp  =  D  *ap 

Parameters 

Value  of  V  when  off 
Vom  Value  of  V  when  on 

tP  Matrix  of  pulse  times  (2 xnr): 

column  1  are  pulse  on  times. 

column  2  are  pulse  off  times. 

unlimited  number  of  n,  rows. 

States 

None 

Equations 

If  the  time  /  falls  between  an  on  and  an  off  time  then  V  =  VOK,  otherwise  v  =  v+ 

If  a  discontinuity  falls  within  the  time  interval,  the  earliest  discontinuity  time  should 
be  passed  back  as  a  recommended  recalculation  time.  The  time  of  the  next  discontiuity 
after  the  time  interval  should  also  be  made  available  to  the  system  solver. 

Structural  Jacobian 

There  is  no  structural  jacobian  matrix  for  this  device. 

Jacobian  Calculations 

There  is  no  jacobian  matrix  for  this  device. 


Type 

Information 

=  [V] 
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F-ll  Induction  Motor 


F-ll.l  ABC  Mode! 


Interface  Variables 


Terminal 


Potential  Variable  Flow  Variables  (KCL  Group)  Type 


Phase  A 
Phase  B 
Phase  C 
Neutral 


VA  (Import) 
VB  (Import) 
Vc  (Import) 
V0  (Import) 


IA  (Export) 
IB  (Export) 
Ic  (Export) 
I0  (Export) 


(1)  Normal 
(1)  Normal 
(1)  Normal 
(1)  Normal 


Mechanical 


com  (Import) 


Tm  (Export)  (0)  Normal 


Voltages  are  in  volts,  currents  in  amps,  angle  speed  in  radians  per  second  and 
Torque  in  Newton-meters. 

The  import  and  export  xexp  vectors  are  given  by: 


- I 

>5 

_ l 

I 

- 1 

v. 

4 

Vc 

11 

4 

V0 

4 

1 - 

£ 

1 _ 

- 1 

_ i 

Parameters 


Rs  Stator  Resistance  (ohms) 

R B  Rotor  Resistance  (reflected  to  Stator)  (ohms) 

Stator  Reactance  (ohms) 

Xu  Rotor  Reactance  (reflected  to  Stator)  (ohms) 

Xu  Mutual  Reactance  (ohms) 

J  Moment  of  Inertia  (Kg-m2) 

c ohs  Base  Frequency  (radians  per  second) 

pf  Pole  Pairs 

B  Windage  Torque  Factor  (Newton-Meters-second) 
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States 

0  Electrical  Rotor  Angle  (radians) 

Equations 

First  calculate  the  electrical  angle: 

6  =  60  +  jpP<»mdt 

Now  specify  the  following  stator  voltage  and  current  vectors: 

~Va-Vo'  rv 

vs  ~  o  is  —  4 

VC-V0J  [/c_ 


The  Rotor  voltages  and  currents  as  reflected  on  the  stator  are: 


Calculate  the  inductances: 


The  Stator  induction  matrix  is  given  by: 


(4j 

-\L~ 

J-L 

2 

(4.+4J 

-h 

2 

~2Lms 

<4,+4J 

The  Rotor  induction  matrix  is  given  by: 
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-\l~. 

~2Lms 

~2L™ 

(V+4J 

The  Mutual  induction  matrix  is  given  by: 


The  Rotor  and  Stator  resistance  matrices  are  given  by: 

'/  0  0]  [7  0  O' 

/?/  =  /?*  0/0  K  =  Rs  0/0 

[o  0  1}  L°  o  /_ 


The  system  of  equations  which  need  to  be  solved  can  be  expressed  as: 
vs  Rs+S  Ls  S  Lx#  is 

.vj  [s-'^y  j?/+s-'vJLv 

For  a  squirrel  cage  induction  motor  v/  =  0.  Hence  the  rotor  curents  can  be  solved 
for: 

h  ~  ARsh 

AKS=-iR/+s-iLRrls-\LSR  y 

=  -(S*r'+L/)-,(Lay 

Now  the  stator  currents  can  be  solved  for. 
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ASs  —  (^j  ■*"  S  4s  +  5  L^j 


-If  /  a 


h  ~  ^ssvs 


The  neutral  current  is  solved  using  KCL; 

4  =  “4  “  4  “  4 

The  electrical  torque  is  given  by: 

2 XuPp  ' 


T  =  — 


3  to. 


w 


M(/JM 

f 


**22) 


r  '  U 

2  2 


M(/C)M 


j  •  j  ' 
lc*  ~  2  2 


sin(0)  + 


•^1 (Mfe)M(V  -4«') + W,m>a -W+tfftW,'  ■ 


The  full  torque  equation  is  given  by: 
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Jacobian  Calculations 


The  jacobian  elements  corresponding  to  the  electrical  variables  are  easy  to 
calculate.  If  we  partition  the  jacobian  matrix  as  follows: 


where 
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The  remaining  matrices  (Jew,  Jte ,  Jtw)  3x&  not  35  easy  to  calculate: 
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Appendix  G:  WAVESIM  Program  Files 


WAVESIM  consists  of  ten  program  source  code  ( .  c)  files  plus  three  header  ( .  h)  files 
and  must  be  linked  to  the  standard  math  library.  Six  of  the  program  source  code  files  and 
two  of  the  header  files  are  specific  to  WAVESIM  while  the  remaining  files  contain 
application  independent  code. 

WAVESIM  SPECIFIC  FILES 


wavesim. c 

Main  Executive  Routine 

wavesim.h 

Definition  of  WAVESIM  Structures 

waveinit . c 

Initialization  of  Structures 

Read  device .  def 

waveinit . h 

Define  Initial  values  of  all  system  parameters 

waveread . c 

Read  and  interpret  Input  File 

wavebld . c 

Build  System 

wavewrit . c 

Write  MATLAB  .M  file 

wave  wirt  a .  c 

Write  MATLAB  .M  file  (continued) 

APPLICATION  INDEPENDENT  FILES 

ioliba . c 

String  Manipulation  Routines 

iolbia.h 

declarations  of  ioliba .  c  routines 

get_file.c 

Prompt  for  and  open  files 

getline . c 

Obtain  string  from  an  input  stream 

filebase.c 

File  name  manipulation  routines 
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G-l  Main  Program  File:  wavesim.  c 

wavesim .  c  contains  the  main  routine 
WAVESIM: 

1 .  Initialize  device  definitions 

2.  Print  the  Header 

3.  Open  Files 

4.  Read  Input  File 

5.  Build  the  System 

6.  Write  The  Output  File 

7.  Gose  the  Files 


which  performs  the  executive  functions  for 

init_devices 

read_file 
build_system 
write  file 
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G-2  System  Initialization:  waveinit .  c 

waveinit .  c  contains  the  following  routines  for  initializing  the  system: 

init_devices 

Sets  Default  Values 

Calls  read  device_def  to  read  in 
device .  def  file. 

Debug  handler. 

read  device_def 

Reads  in  device .  def  file 

print  system_base 

Prints  system  base  parameters 

print  device_def 

Prints  a  Device  Definition 

print  matrix 

Prints  a  Matrix 

print  structural_jacobian 

Prints  a  Structural  Jacobian 

read  terminal 

Interprets  TERMINAL  subordinate 
command 

read_jparameter 

Interprets  PARAMETER  subordinate 
command 

read_state 

Interprets  STATE  subordinate 

command 

read  function 

Interprets  FUNCTION  subordinate 
command 

read  structural_jacobian 

Interprets  STRUCTURAL 

JACOBIAN  subordinate  command 

8trip_white 

Strips  all  blanks,  tabs,  returns  from  a 
string. 

read_matrix 

Reads  a  matrix. 
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The  hierarchy  for  the  routines  in  waveinit .  c  is  given  by: 

init_devices 

read_device_def 
read__terminal 
readjparameter 
read_matrix 
read_state 
read_function 
read_st  ructur  al_j  acobian 
strip_white 
print_system_base 
pr int_de vi ce_de f 
print_matrix 

print_structural_  j  acobiam 
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G-3  Reading  Input  File:  waveread.  c 


wave  re  ad.  c  contains  the  following  routines  for  reading  in  an  input  file: 

read  file  Controls  other  routines  for  reading 

input  files 
Debug  handler. 


read  file  device 


Reads  and  Interprets  device 
command  from  input  file. 


read  file  default 


read  file  node 


read  file  time 


read  file_debug 


Reads  and  Interprets  default 
command  from  input  file. 

Reads  and  Interprets  node  command 
from  input  file. 

Reads  and  Interprets  time  command 
from  input  file. 

Reads  and  Interprets  debug 
command  from  input  file. 


print_debug 


Print  debug  flag  status. 


print_time 

print_device 

print_system 


Print  simulation  time  parameters. 
Print  device  characteristics. 

Print  system  characteristics. 


print  node  Print  node  characteristics. 

finish  reading_file  Generate  cross  references  and 

generally  finish  the  process  of 
developing  the  initial  system. 
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The  hierarchy  for  the  routines  in  waveread .  c  is  given  by: 

read_f ile 

read_f  i  le__device 
print_device 
print_matrix 
read_matrix 
read_f i le_def ault 
print_system_base 
read_f i 1 e_node 
print__node 
read  file_tiine 
print_time 
read_file_debug 
print_debug 
finish_reading_f ile 
print_system 
print_device 
print_node 
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G-4  Building  the  System:  wavebld. c 


wavebld .  c  contains  the  following  routines  for  building  the  system: 
build_system  Identifies  System  variables  and 


build_system_identify 


bui ld_sy st em_xr e f 


equations 

Builds  cross  references 
Builds  System  Structural  Jacobian 
Reduces  system 

Identifies  system  variables  and 
equations. 

Builds  cross  references  within  the 
system. 


build_system_structural_jacobian  Builds  the  system  structural 

jacobian  matrix. 


build_system_blocks 


find  block 


Identifies  the  sequence  of  blocks  for 
solving  system. 

Attempts  to  find  a  block  of  a  given 


pr int_sy st em_ident i f y 
s  j_add 


s  j_sub 


pr int_sy stem_block_s j ac 


Prints  system  information. 

Adds  two  Structural  Jacobian 
codes. 

Subtracts  two  Structural  Jacobian 
codes. 

Prints  the  block  owner  of  each 
element  in  the  system  sructural 
jacobian  matrix. 


print_block 


Prints  information  about  a  block. 
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The  hierarchy  for  the  routines  in  vtavebld .  c  is  given  by: 

bui ld_ay st em 

build_system_identify 
pr  int_sy  s t  em_i  dent  i  f  y 
build_system__xref 
build  system  structural  jacobian 
s  j_add 
s  j_sub 

print_structural_jacobian 

build_system_blocks 

find_block 

print_block 

print_structural— jacobian 
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G-5  Writing  MATLAB  M-File:  wavewrit .  c  and  wavewrta .  c 


wavewrit .  c  and  wavewrta .  c  contain  the  following  routines  for  writing  the 


output  MATLAB  M-File: 

write_file 

write_file_header 
write_file_initialize 
Hr  it  o_f  i  le_t  ime__loop 
wr  ite_f  ile_plot_variables 
write_file_footer 

write  file  solve  block 


Calls  other  routines  to  generate 
MATLAB  M-File. 

Prints  header  information  to 
MATLAB  M-File. 

Prints  System  Initialization 
parameters  to  MATLAB  M-File. 

Prints  Time  Loop  algorithm  to 
MATLAB  M-File. 

Prints  algorithm  to  plot  system 
variables  to  MATLAB  M-File 

Prints  Footer  information  to 
MATLAB  M-File. 

Prints  algorithm  for  solving  block  to 
MATLAB  M-File. 


The  hierarchy  for  the  routines  in  wavewrit .  c  and  wavewrta .  c  is  given  by: 

write_file 

write_file_header 
wr  it  e__f  i  le_int  i  al  i  z  e 
wr  ite_f  ile_t  ime__loop 
wr  ite__f  i  le_solve_Jblock 
write  file  footer 
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G-6  Application  Independent  Files 

Several  Support  files  containing  special  C  functions  are  required  by  WAVESLM. 
These  files  were  written  by  the  author  independently  of  WAVESIM  and  may  contain 
routines  unused  by  WAVESIM. 

G-6.1  ioliba.  c 

ioliba .  c  contains  a  number  of  functions  for  manipulating  strings.  The  functions 
used  by  WAVESIM  are: 

Sto<ia  Converts  a  string  to  an  array  of  double  precision  floating 

numbers. 

strextract  Extracts  the  nth  word  of  a  string 

str split  Returns  the  remainder  of  a  string  after  the  nth  word. 

strstrip  Strips  a  string  of  leading  and  trailing  spaces,  tabs,  and 

carriage  returns 

strncmpa  Case  insensitive  version  of  strncanp  for  comparing  the 

first  n  characters  of  two  strings. 

strcxnpa  Case  insensitive  version  of  strcmp  for  comparing  two 

strings. 
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G-6.2  get  line .  c 

getline.c  contains  functions  for  reading  in  lines  from  a  file  and  automatically 
implementing  the  following  features: 

1.  Comment  Lines  beginning  with  #,  ! ,  or  %  are  ignored. 

2.  Blank  Lines  are  ignored. 

3.  Lines  can  be  continued  with  ...  or  \. 

4.  If  the  first  word  of  the  line  is  INCLUDE  followed  by  a  filename,  lines  are  read 
from  that  file.  (NOTE:  A  check  for  recursive  INCLUDE  statements  is 
performed  to  prevent  infinite  loops) 

5.  Carriage  Returns  are  truncated. 

The  functions  used  by  WAVES1M  are: 
init_strm  Initialization  function 

get_line  Function  used  to  read  the  lines  in. 
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G-6.3  get_f  ile .  c 

get__f  ile .  c  contains  functions  for  opening  input  and  output  files.  The  following 
features  are  implemented: 

1.  Two  strings  are  passed:  a  default  filename  string  and  an  argument  filename 
string.  Either  or  both  strings  may  be  empty. 

2.  If  the  argument  filename  is  specified,  the  functions  attempt  to  open  that  file. 
If  opening  that  file  is  unsuccessful,  the  user  is  prompted  to  enter  a  new 
filename. 

3.  If  the  argument  filename  is  empty,  the  user  is  prompted  to  enter  a  filename.  If 
the  default  filename  is  not  empty,  it  is  offered  to  the  user  as  the  default  name 
of  the  file.  If  opening  the  file  entered  by  the  user  is  unsuccessful,  the  user  is 
prompted  to  enter  a  new  filename. 

4.  Users  can  exit  the  routine  without  opening  a  file  by  entering  only  a  q  when 
prompted  for  a  filename 

5.  Users  can  obtain  a  directory  listing  by  entering  a  ?  followed  by  whatever  file 
specification  the  user  desires. 

6.  Leading  and  trailing  spaces  in  filenames  are  truncated. 

7.  Whatever  filename  is  successfully  opened  is  passed  back  as  a  new  default 
filename. 

The  function  used  by  WAVESIM  is: 

get_input_f  il©  Function  for  opening  an  Input  File 

G-6.4  f  ilebase .  c 

f  ilebase .  c  contains  functions  for  stripping  an  extension  off  of  a  filename  and  for 
returning  the  extension  of  a  filename.  The  following  features  are  implemented: 

1 .  An  extension  is  defined  as  all  the  characters  after  the  last  period  (.)  found  after 
the  last  directory  delimiter  (\  for  IBM-DOS  and  /  for  UNIX).  If  no  such  period 
is  found,  the  extension  does  not  exist. 

The  function  used  by  WAVESIM  is: 

extract  base  Extract  the  base  filename  (without  extension) 
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G-7  Makefile 


The  UNIX  make  utility  greatly  eases  the  task  of  developing  programs  by  only  compiling 
those  files  which  have  changed  since  the  last  compilation.  Here  is  the  Makefile  used  to 
generate  WAVESIM  on  a  VAXstation  3100: 

#  Makefile  for  wavesim 

# 

#  For  Revision  2.0 

# 

FILES  =  wavesim. c  ioliba.c  getline.c  get_file.c  filebase.c  \ 
waveinit.c  waveread.c  wavewrit . c  wavewrta.c  \ 
wavebld. c 

OBJ  =  wavesim. o  ioliba.o  getline.o  get_file.o  filebase.o  \ 
waveinit.o  waveread.o  wavewrit.o  wavewrta.o  \ 
wavebld. o 

HEADER=  wavesim. h  ioliba.h 
CFLAG  =  -g 
COMPILE  =  cc 

# 

# 

# 

wavesim:  $ (HEADER)  $ (OBJ) 

$ (COMPILE)  -o  wavesim  $ (CFLAG)  $ (OBJ)  -lm 
wavesim. o:  $ (HEADER)  wavesim. c 

$ (COMPILE)  -c  $ (CFLAG)  wavesim. c 
ioliba.o:  ioliba.h  ioliba.c 

$ (COMPILE)  -c  $ (CFLAG)  ioliba.c 
getline.o:  getline.c 

$ (COMPILE)  -C  $ (CFLAG)  getline.c 
get_file.o:  get_file.c 

$ (COMPILE)  -c  $ (CFLAG)  get_file.c 
filebase.o:  filebase.c 

$ (COMPILE)  -c  $ (CFLAG)  filebase.c 
waveinit.o:  $ (HEADER)  waveinit.h  waveinit.c 
$ (COMPILE)  -c  $ (CFLAG)  waveinit.c 
waveread.o:  $ (HEADER)  waveread.c 

$ (COMPILE)  -c  $ (CFLAG)  waveread.c 
wavewrit.o:  $ (HEADER)  wavewrit. c 

$  (COMPILE)  -c  $ (CFLAG)  wavewrit.o 
wavewrta.o:  $ (HEADER)  wavewrta.c 

$ (COMPILE)  -c  $ (CFLAG)  wavewrta.c 
wavebld. o:  $ (HEADER)  wavebld. c 

$ (COMPILE)  -c  $ (CFLAG)  wavebld. c 


# 

# 

# 

lint : 

lint  $ (FILES) 
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